Changes in PHPUnit 8.5

All notable changes of the PHPUnit 8.5 release series are documented in this file using the Keep a CHANGELOG principles.

8.5.21 - 2021-09-25

Changed

PHPUnit no longer converts PHP deprecations to exceptions by default (configure convertDeprecationsToExceptions="true" to enable this)
The PHPUnit XML configuration file generator now configures convertDeprecationsToExceptions="true"

Fixed

#4772: TestDox HTML report not displayed correctly when browser has custom colour settings

8.5.20 - 2021-08-31

Fixed

#4751: Configuration validation fails when using brackets in glob pattern

8.5.19 - 2021-07-31

Fixed

#4740: phpunit.phar does not work with PHP 8.1

8.5.18 - 2021-07-19

Fixed

#4720: PHPUnit does not verify its own PHP extension requirements

8.5.17 - 2021-06-23

Changed

PHPUnit now errors out on startup when PHP_VERSION contains a value that is not compatible with version_compare(), for instance X.Y.Z-(to be removed in future macOS)

8.5.16 - 2021-06-05

Changed

The test result cache (the storage for which is implemented in PHPUnit\Runner\DefaultTestResultCache) no longer uses PHP's serialize() and unserialize() functions for persistence. It now uses a versioned JSON format instead that is independent of PHP implementation details (see #3581 and #4662 for examples why this is a problem). When PHPUnit tries to load the test result cache from a file that does not exist, or from a file that does not contain data in JSON format, or from a file that contains data in a JSON format version other than the one used by the currently running PHPUnit version, then this is considered to be a "cache miss". An empty DefaultTestResultCache object is created in this case. This should also prevent PHPUnit from crashing when trying to load a test result cache file created by a different version of PHPUnit (see #4580 for example).

Fixed

#4663: TestCase::expectError() works on PHP 7.3, but not on PHP >= 7.4
#4678: Stubbed methods with iterable return types should return empty array by default
#4692: Annotations in single-line doc-comments are not handled correctly
#4694: TestCase::getMockFromWsdl() does not work with PHP 8.1-dev

8.5.15 - 2021-03-17

Fixed

#4591: TeamCity logger logs warnings as test failures

8.5.14 - 2021-01-17

Fixed

#4535: getMockFromWsdl() does not handle methods that do not have parameters correctly
#4572: Schema validation does not work with %xx sequences in path to phpunit.xsd
#4575: PHPUnit 8.5 incompatibility with PHP 8.1

8.5.13 - 2020-12-01

Fixed

Running tests in isolated processes did not work with PHP 8 on Windows

8.5.12 - 2020-11-30

Changed

Changed PHP version constraint in composer.json from ^7.2 to >=7.2 to allow the installation of PHPUnit 8.5 on PHP 8. Please note that the code coverage functionality is not available for PHPUnit 8.5 on PHP 8.

Fixed

#4529: Debug mode of Xdebug 2 is not disabled for PHPT tests

8.5.11 - 2020-11-27

Changed

Bumped required version of phpunit/php-code-coverage

8.5.10 - 2020-11-27

Added

Support for Xdebug 3

Fixed

#4516: phpunit/phpunit-selenium does not work with PHPUnit 8.5.9

8.5.9 - 2020-11-10

Fixed

#3965: Process Isolation throws exceptions when PHPDBG is used
#4470: Infinite recursion when --static-backup --strict-global-state is used

8.5.8 - 2020-06-22

Fixed

#4312: Fix for #4299 breaks backward compatibility

8.5.7 - 2020-06-21

Fixed

#4299: "No tests executed" does not always result in exit code 1
#4306: Exceptions during code coverage driver initialization are not handled correctly

8.5.6 - 2020-06-15

Fixed

#4211: phpdbg_*() functions are scoped to PHPUnit\phpdbg_*()

8.5.5 - 2020-05-22

Fixed

#4033: Unexpected behaviour when $GLOBALS is deleted

8.5.4 - 2020-04-23

Changed

Changed how PHPUnit\TextUI\Command passes warnings to PHPUnit\TextUI\TestRunner

8.5.3 - 2020-03-31

Fixed

#4017: Do not suggest refactoring to something that is also deprecated
#4133: expectExceptionMessageRegExp() has been removed in PHPUnit 9 without a deprecation warning being given in PHPUnit 8
#4139: Cannot double interfaces that declare a constructor with PHP 8
#4144: Empty objects are converted to empty arrays in JSON comparison failure diff

8.5.2 - 2020-01-08

Removed

eval-stdin.php has been removed, it was not used anymore since PHPUnit 7.2.7

8.5.1 - 2019-12-25

Changed

eval-stdin.php can now only be executed with cli and phpdbg

Fixed

#3983: Deprecation warning given too eagerly

8.5.0 - 2019-12-06

Added

#3911: Support combined use of addMethods() and onlyMethods()
#3949: Introduce specialized assertions assertFileEqualsCanonicalizing(), assertFileEqualsIgnoringCase(), assertStringEqualsFileCanonicalizing(), assertStringEqualsFileIgnoringCase(), assertFileNotEqualsCanonicalizing(), assertFileNotEqualsIgnoringCase(), assertStringNotEqualsFileCanonicalizing(), and assertStringNotEqualsFileIgnoringCase() as alternative to using assertFileEquals() etc. with optional parameters

Changed

#3860: Deprecate invoking PHPUnit commandline test runner with just a class name
#3950: Deprecate optional parameters of assertFileEquals() etc.
#3955: Deprecate support for doubling multiple interfaces

Fixed

#3953: Code Coverage for test executed in isolation does not work when the PHAR is used
#3967: Cannot double interface that extends interface that extends \Throwable
#3968: Test class run in a separate PHP process are passing when exit called inside