Release Announcement for PHPUnit 5.0.0

Sebastian Bergmann edited this page Feb 8, 2017 · 8 revisions

The PHPUnit development team announces the immediate availability of PHPUnit 5.0.0. This release adds new features, removes existing features, and fixes bugs. A detailed list of changes is available here.

New Features

  • A @small test can now optionally be marked as risky when it executes code that performs I/O operations (requires Xdebug 3)
  • Added the assertFinite(), assertInfinite() and assertNan() assertions
  • Support for deep-cloning of results passed between tests using @depends
  • Expectations on mock objects passed via @depends are now also evaluated for the depending test


  • It is now mandatory to configure a whitelist for code coverage analysis

Removal of deprecated functionality

Functionality that was marked as deprecated in PHPUnit 4 has been removed in PHPUnit 5. This includes the following features

  • The assertSelectCount(), assertSelectRegExp(), assertSelectEquals(), assertTag(), assertNotTag() assertions
  • The --strict commandline switch and the strict configuration file setting
  • The configuration file settings related to PHPUnit_Selenium

Dropping support for PHP 5.3, PHP 5.4, and PHP 5.5

According to our release process, PHPUnit must be compatible with all versions of PHP that are actively supported by the PHP project.

Active support for PHP 5.3 ended on July 11, 2013, active support for PHP 5.4 ended on September 14, 2014, and active support for PHP 5.5 ended on June 20, 2015. The only actively supported version of PHP as of October, 2 2015 is PHP 5.6.

Support for PHP 7

PHPUnit 5 is supported on PHP 7.

Obtaining PHPUnit 5.0

We distribute a PHP Archive (PHAR) that contains everything you need in order to use PHPUnit. Simply download it from here, make it executable, and put it into your $PATH, for instance.

Alternatively, you may use Composer to download and install PHPUnit as well as its dependencies.


PHPUnit 5.0 requires PHP 5.6; using the latest version of PHP is highly recommended. The documentation has a detailed list of the PHP extensions that are required to use PHPUnit.

Looking Ahead

The goal of our release process is to deliver new features into the hands of our users every two months. The following releases are currently in development:

  • PHPUnit 5.1 is the current beta release series of PHPUnit. It will become stable on December 4, 2015.
  • PHPUnit 5.2 is the current alpha release series of PHPUnit. It will become stable on February 5, 2016.

PHPUnit 6

PHPUnit 6, which is scheduled for August 5, 2016 February 3, 2017, will no longer support PHP 5. As PHPUnit follows Semantic Versioning the major version number must be incremented when the minimum required version of PHP is increased.

Support for PHPUnit 5

Following our release process, PHPUnit 5 will receive bug fixes until August 5, 2017 February 3, 2017.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.