The PHP Unit Testing framework.
PHP Shell
Pull request Compare This branch is 5822 commits behind sebastianbergmann:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



PHPUnit is the de-facto standard for unit testing in PHP projects. It provides both a framework that makes the writing of tests easy as well as the functionality to easily run the tests and analyse their results.


  • PHPUnit 3.6 requires PHP 5.2.7 (or later) but PHP 5.3.8 (or later) is highly recommended.
  • PHP_CodeCoverage, the library that is used by PHPUnit 3.6 to collect and process code coverage information, depends on Xdebug 2.0.5 (or later) but Xdebug 2.1.2 (or later) is highly recommended.


PHPUnit should be installed using the PEAR Installer, the backbone of the PHP Extension and Application Repository that provides a distribution system for PHP packages.

Depending on your OS distribution and/or your PHP environment, you may need to install PEAR or update your existing PEAR installation before you can proceed with the instructions in this chapter. sudo pear upgrade PEAR usually suffices to upgrade an existing PEAR installation. The PEAR Manual explains how to perform a fresh installation of PEAR.

The following two commands are all that is required to install PHPUnit using the PEAR Installer:

pear config-set auto_discover 1
pear install

After the installation you can find the PHPUnit source files inside your local PEAR directory; the path is usually /usr/lib/php/PHPUnit.


The documentation for PHPUnit is available in different formats:

Mailing Lists

  • Send an email to to subscribe to the phpunit-user mailing list. This is a medium volume list for general PHPUnit support; ask PHPUnit questions here.
  • Send an email to to subscribe to the phpunit-dev mailing list. This is a low volume list for those who want to help out with the development of PHPUnit.


The #phpunit channel on the Freenode IRC network is a place to chat about PHPUnit.

Using PHPUnit From a Git Checkout

The following commands can be used to perform the initial checkout of PHPUnit and its dependencies from Git:

mkdir phpunit && cd phpunit
git clone git://
git clone git://
git clone git://
git clone git://
git clone git://
git clone git://
git clone git://
git clone git://
git clone git://
git clone git://
git clone git://

The dbunit, php-code-coverage, php-file-iterator, php-text-template, php-timer, php-token-stream, phpunit, phpunit-mock-objects, phpunit-selenium, phpunit-story, and php-invoker directories need to be added to the include_path.

The phpunit/phpunit.php script can be used to invoke the PHPUnit test runner.