A parallelizer for running PHPUnit on multiple nodes. While many plugins exist to run PHPUnit in parallel processes, this extensions allows for running PHPUnit in parallel on multiple nodes. This is often required in various CI services such as CircleCI and TravisCI.
The development environment for this project is configured using docker, removing the need to actually install
anything on your maching. Simply install the Docker Engine and
use the scripts in bin/.
An entrypoint script is packaged with the extension (entitle phpunit-parallel.php). This can be run with the
arguments --current-node and --total-nodes representing the index of the node in the cluster (numbered 0-n)
and the total number of nodes in the cluster (n), respectively.
The --current-node option expects a 0-indexed value. That is for a cluster with 3 nodes, the node indexes would
be 0, 1, and 2.
> phpunit-parallel.php --current-node=0 --total-nodes=1 tests/
> phpunit-parallel.php --current-node=2 --total-nodes=5 tests/
> phpunit-parallel.php --current-node=1 --total-nodes=2 --configuration phpunit.xml
- Clone the repository
- In the project root run composer
> bin/composer install
- Run the unit tests packaged with this extension
> bin/phpunit