Decision Use PHPUnit for unit testing PHP code

accepted

Using a testing framework like PHPUnit in all our projects will speed up test authoring and increase reliability of our tests.

PHPUnit is the most popular framework for unit testing in PHP. It is a well maintained and well documented project. Drupal and Symfony use PHPUnit for their unit tests.

Other options briefly considered:

  • Custom classes that use the assert global funtion
  • SimpleTest

Decision

We will use the PHPUnit framework when writing unit tests for PHP code.

In CI, these tests will be executed using the built-in PHPUnit CLI test runner. Locally tests can be executed using the CLI or IDE integrations.

Consequences

Using the same tool in all our projects will allow the team to deepen our expertise with PHPUnit, be more efficient when writing tests, and transition to other projects more easily.