Install PHPUnit within your Chassis box! The PHPUnit extension automatically sets up your Chassis instance with the phpunit executable, for use running PHP unit tests.

To add the phpunit extension to a Chassis box, include chassis/phpunit in the extensions list within your config.local.yaml file:

extensions:
    - chassis/phpunit

Then run vagrant provision to instruct Chassis to download and install the new extension.

Ensure you have a Chassis instance set up locally already.

# In your Chassis dir:
cd extensions

# Grab the extension
git clone --recursive https://github.com/Chassis/phpunit.git phpunit

# Reprovision
cd ..
vagrant provision

vagrant ssh
cd /vagrant/content/{plugins|themes}/yourdirectory
phpunit

You're now ready to run phpunit within your Chassis virtual machine!

To specify a version of PHPUnit to install, add the following to your Chassis config file:

phpunit:
  version: 5.7

You can specify the version to with either two or three digits, eg 5.7 or 5.7.10.

For PHP versions 7.0 and over the default version is 5.7. For PHP version 5.6 the default version is 4.8.

We currently support the following versions of PHPUnit:

• 4.8
• 6.5
• 7.5
• 8.x
• 9.x