sebastianbergmann/phpunit (phpunit/phpunit)
v12.4.2: PHPUnit 12.4.2
Compare Source 
Changed
- Skipped tests alone no longer lead to a yellow background for the test result summary
Fixed
- #6391: Errors during backup of global variables and static properties are not reported
Learn how to install or update PHPUnit 12.4 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.4.1: PHPUnit 12.4.1
Compare Source 
Fixed
- #6364: --filterformat used by PhpStorm stopped working
- #6378: Wrong method name passed to DataProviderMethodCalledevent value object
Learn how to install or update PHPUnit 12.4 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.4.0: PHPUnit 12.4.0
Compare Source 
Added
- #6277: Allow tests to opt out of the validation that a data provider method does not provide data sets with more values than a test method accepts
- #6341: Support for regular expressions with #[IgnoreDeprecations]attribute
- #6354: Invokable constraints
Deprecated
- #6284: #[RunClassInSeparateProcess]attribute
- #6355: Support for version constraint string argument without explicit version comparison operator
Learn how to install or update PHPUnit 12.4 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.15: PHPUnit 12.3.15
Compare Source 
Fixed
- #6368: failOnPhpunitWarning="false"has no effect
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.14: PHPUnit 12.3.14
Compare Source 
- No changes; phpunit.pharrebuilt with updated dependencies
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.13: PHPUnit 12.3.13
Compare Source 
- No changes; phpunit.pharrebuilt with updated dependencies
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.12: PHPUnit 12.3.12
Compare Source 
- No changes; phpunit.pharrebuilt with updated dependencies
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.11: PHPUnit 12.3.11
Compare Source 
Changed
- #6366: Exclude __sleep()and__wakeup()from test double code generation on PHP >= 8.5
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.10: PHPUnit 12.3.10
Compare Source 
Changed
- #6353: Disable performance optimization for tests requiring Xdebug
- #6357: Also collect E_DEPRECATEDissues when building the test suite
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.9: PHPUnit 12.3.9
Compare Source 
Changed
- Do not use __sleep()method (which will be deprecated in PHP 8.5)
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.8: PHPUnit 12.3.8
Compare Source 
Fixed
- #6340: Implicitly enabled display of deprecation details is not disabled when it should be
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.7: PHPUnit 12.3.7
Compare Source 
Changed
- #[IgnorePhpunitDeprecations]is now considered for test runner deprecations (where applicable)
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
Compare Source 
v12.3.5: PHPUnit 12.3.5
Compare Source 
Changed
- #6319: Detect premature end of PHPUnit's main PHP process
- #6321: Allow error_reporting=E_ALLfor--check-php-configuration
Fixed
- #5863: TestDox printer does not show previous exception
- #6102: expectUserDeprecationMessage*()fails when test is run in separate process
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.4: PHPUnit 12.3.4
Compare Source 
Changed
- #6308: Improve output of --check-php-configuration
- The version number for the test result cache file has been incremented to reflect that its structure for PHPUnit 12.3 is not compatible with its structure for PHPUnit 8.5 and PHPUnit 9.6
Fixed
- #6197: ini_set('error_log')sets filepath outsideopen_basedir
- #6279: Deprecation triggered in data provider method affects all test methods using that data provider method
- #6281: Exceptions raised in after-test method are not reported for skipped tests
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.3: PHPUnit 12.3.3
Compare Source 
Fixed
- #6304: PHPUnit 11.5.29 hangs when a test runner deprecation is triggered and process isolation is used (this reverts "#[IgnorePhpunitDeprecations]is now considered for test runner deprecations" from PHPUnit 12.3.1)
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.2: PHPUnit 12.3.2
Compare Source 
Changed
- #6300: Emit warning when the name of a data provider method begins with test
- Do not use SplObjectStoragemethods that will be deprecated in PHP 8.5
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.1: PHPUnit 12.3.1
Compare Source 
Added
- #6297: --check-php-configurationCLI option for checking whether PHP is configured for testing
Changed
- #[IgnorePhpunitDeprecations]is now considered for test runner deprecations (where applicable)
Fixed
- #6160: Baseline file in a subdirectory contains absolute paths
- #6294: Silent failure of PHP fatal errors
- Errors due to invalid data provided using #[TestWith]or#[TestWithJson]attributes are now properly reported
- The DataProviderMethodFinishedevent is now also emitted when the provided data set has an invalid key
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v12.3.0: PHPUnit 12.3.0
Compare Source 
Added
- #3795: Bootstrap scripts specific to test suites
- #6268: #[IgnorePHPUnitWarnings]attribute for ignoring PHPUnit warnings
- #[TestDoxFormatter]and- #[TestDoxFormatterExternal]attributes for configuring a custom TestDox formatter for tests that use data from data providers
- TestRunner\ChildProcessErroredevent
- Configuration::includeTestSuites()and- Configuration::excludeTestSuites()
Changed
- #6237: Do not run tests when code coverage analysis is requested but code coverage data cannot be collected
- #6272: Use @<data-set-name>format (compatible with--filterCLI option) in defect messages
- #6273: Warn when #[DataProvider*]attributes are mixed with#[TestWith*]attributes
Deprecated
- #6229: Configuration::includeTestSuite(), useConfiguration::includeTestSuites()instead
- #6229: Configuration::excludeTestSuite(), useConfiguration::excludeTestSuites()instead
- #6246: Using #[CoversNothing]on a test method
How to install or update PHPUnit 
v12.2.9: PHPUnit 12.2.9
Compare Source 
Fixed
- #6097: The fileattribute of<testClass>node of XML test list can be wrong
How to install or update PHPUnit 
v12.2.8: PHPUnit 12.2.8
Compare Source 
Fixed
- #6274: Infinite recursion when code coverage report in OpenClover XML format is configured in XML configuration file
How to install or update PHPUnit 
v12.2.7: PHPUnit 12.2.7
Compare Source 
Fixed
- #6254: defects,randomconfiguration is supported by implementation, but it is not allowed by the XML configuration file schema
- #6259: Order of tests which use data from data providers is not affected by test sorting
- #6266: Superfluous whitespace in TestDox output when test method name has a number after the testprefix
How to install or update PHPUnit 
v12.2.6: PHPUnit 12.2.6
Compare Source 
Fixed
- #6104: Test with dependencies and data provider fails
- #6163: @no-named-argumentsleads to static analysis errors for variadic arguments
How to install or update PHPUnit 
v12.2.5: PHPUnit 12.2.5
Compare Source 
Fixed
- #6249: No meaningful error when <testsuite>element is missing requirednameattribute
How to install or update PHPUnit 
v12.2.4: PHPUnit 12.2.4
Compare Source 
Changed
- Including information about the Git repository (such as the commit hash and branch name) in the Open Test Reporting XML format is now an opt-in feature that can be enabled via the --include-git-informationCLI option or theincludeGitInformationattribute in the XML configuration file
How to install or update PHPUnit 
v12.2.3: PHPUnit 12.2.3
Compare Source 
Added
- #6236: failOnPhpunitWarningattribute on the<phpunit>element of the XML configuration file and--fail-on-phpunit-warningCLI option for controlling whether PHPUnit should fail on PHPUnit warnings (default:true)
- #6239: --do-not-fail-on-deprecation,--do-not-fail-on-phpunit-warning,--do-not-fail-on-phpunit-deprecation,--do-not-fail-on-empty-test-suite,--do-not-fail-on-incomplete,--do-not-fail-on-notice,--do-not-fail-on-risky,--do-not-fail-on-skipped, and--do-not-fail-on-warningCLI options
- --do-not-report-useless-testsCLI option as a replacement for- --dont-report-useless-tests
Deprecated
- --dont-report-useless-testsCLI option (use- --do-not-report-useless-testsinstead)
Fixed
- #6243: Constraints cannot be implemented without using internal class ExpectationFailedException
How to install or update PHPUnit 
v12.2.2: PHPUnit 12.2.2
Compare Source 
Fixed
- #6222: Data Provider seems to mess up Test Dependencies
- shortenArraysForExportThresholdXML configuration setting has no effect on all arrays exported for event-related value objects
How to install or update PHPUnit 
v12.2.1: PHPUnit 12.2.1
Compare Source 
Fixed
- #6228: Variadic test methods should not warn about too many arguments from data provider
How to install or update PHPUnit 
v12.2.0: PHPUnit 12.2.0
Compare Source 
Added
Experimental Support for Open Test Reporting XML
PHPUnit has supported reporting test results in the JUnit XML format for a long time. Unfortunately, there has never been a standard schema for the JUnit XML format. Common consumers of Clover XML log files interpret these files differently, which has led to frequent problems.
To address this, the JUnit team started the Open Test Reporting project, creating and maintaining language-agnostic XML and HTML test reporting formats. Unlike JUnit XML, Open Test Reporting's XML formats are extensible.
Logging in the Open Test Reporting XML format is controlled by the new --log-otr CLI option and the new <otr> XML configuration element.
This feature is experimental and the generated XML may change in order to enhance compliance with the Open Test Reporting project's XML schema definitions. The same applies to the XML schema definitions for information that is specific for PHP and PHPUnit. Please note that such changes may occur in bugfix or minor releases and could potentially break backwards compatibility.
Experimental Support for OpenClover XML
PHPUnit has supported reporting code coverage information in the Clover XML format for a long time. Unfortunately, there has never been a standard schema for the Clover XML format. Common consumers of Clover XML log files interpret these files differently, which leads to frequent problems.
The original commercial Clover project has been superseded by the Open Source OpenClover project, which provides an XML schema for its OpenClover XML format. Rather than modifying the existing Clover XML reporter to comply with the OpenClover XML schema, thereby breaking backward compatibility, a new OpenClover XML reporter has been introduced.
This new reporter is controlled by the new CLI option, --coverage-openclover, and the new XML configuration element, <openclover>. This code coverage reporter generates XML documents that validate against the OpenClover project's XML schema definition, with one exception: the <testproject> element is not generated.
The existing Clover XML reporter, controlled by the --coverage-clover CLI option and the <clover> XML configuration element, remains unchanged.
This feature is experimental and the generated XML may change to enhance compliance with the OpenClover XML schema definition. Please note that such changes may occur in bugfix or minor releases and could potentially break backwards compatibility.
Miscellaneous
- --with-telemetryCLI option that can be used together with- --debugto print debugging information that includes telemetry information
- The TestCase::provideAdditionalInformation()method can now be used to emit aTest\AdditionalInformationProvidedevent
- The new Test\AfterLastTestMethodFailed,Test\AfterTestMethodFailed,Test\BeforeFirstTestMethodFailed,Test\BeforeTestMethodFailed,Test\PostConditionFailed,Test\PreConditionFailedevents are now emitted instead ofTest\AfterLastTestMethodErrored,Test\AfterTestMethodErrored,Test\BeforeFirstTestMethodErrored,Test\BeforeTestMethodErrored,Test\PostConditionErrored,Test\PreConditionErroredwhen theThrowableextendsAssertionFailedErrorto distinguish between errors and failures triggered in hook methods
- The new Test\PreparationErroredevent is now emitted instead ofTest\PreparationFailedwhen theThrowabledoes not extendAssertionFailedErrorto distinguish between errors and failures triggered during test preparation
- Test\PreparationFailed::throwable()
Changed
- #6165: Collect deprecations triggered by autoloading while loading/building the test suite
- Do not treat warnings differently than other issues in summary section of default output
- A warning is now emitted when both #[CoversNothing]and#[Covers*](or#[Uses*]) are used on a test class
- A warning is now emitted when the same #[Covers*](or#[Uses*]) attribute is used multiple times on a test class
- A warning is now emitted when the same code is targeted by both #[Covers*]and#[Uses*]attributes
- A warning is now emitted when a hook method such as setUp(), for example has a#[Test]attribute
- A warning is now emitted when more than one of #[Small],#[Medium], or#[Large]is used on a test class
- A warning is now emitted when a data provider provides data sets that have more values than the test method consumes using arguments
How to install or update PHPUnit 
v12.1.6: PHPUnit 12.1.6
Compare Source 
Changed
- #6210: Set default Clover coverage project name
- #6217: Improve the error message when createStubForIntersectionOfInterfaces()is called with a class
How to install or update PHPUnit 
v12.1.5: PHPUnit 12.1.5
Compare Source 
Fixed
- #6192: Reverted change made in PHPUnit 11.5.19 due to regression
- #6199: assertEmpty()andassertNotEmpty()use overly restrictivephpstan-assert emptydirectives
How to install or update PHPUnit 
v12.1.4: PHPUnit 12.1.4
Compare Source 
Added
- displayDetailsOnAllIssuesattribute on the- <phpunit>element of the XML configuration file and- --display-all-issuesCLI option for controlling whether PHPUnit should display details on all issues that are triggered (default:- false)
- failOnAllIssuesattribute on the- <phpunit>element of the XML configuration file and- --fail-on-all-issuesCLI option for controlling whether PHPUnit should fail on all issues that are triggered (default:- false)
Changed
- #5956: Improved handling of deprecated E_STRICTconstant
Fixed
- #6192: Positive %aand%Amatches are not ignored from diff whenEXPECTFfails
How to install or update PHPUnit 
v12.1.3: PHPUnit 12.1.3
Compare Source 
Changed
- When gathering the telemetry information that each event has, the real size of memory allocated from the operating system is no longer used as this is grown by PHP's memory manager in chunks that are so large that small(er) increases in peak memory usage cannot be seen
- The peak memory usage returned by memory_get_peak_usage()is now reset immediately before theTest\Preparedevent is emitted usingmemory_reset_peak_usage()so that (memory usage atTest\Finished- memory usage atTest\Prepared) is a better approximation of the memory usage of the test
- The string representation of Telemetry\Infonow uses peak memory usage instead of memory usage (this affects--log-events-verbose-text)
Fixed
- #6173: Output from error_log()is not displayed when test fails
- A "Before Test Method Errored" event is no longer emitted when a test is skipped in a "before test" method
How to install or update PHPUnit 
v12.1.2: PHPUnit 12.1.2
Compare Source 
Fixed
- #6104: Reverted change introduced in PHPUnit 12.1.1
How to install or update PHPUnit 
v12.1.1: PHPUnit 12.1.1
Compare Source 
Fixed
- #6104: Test with dependencies and data provider fails
- #6174: willReturnMap()fails with nullable parameters when their default isnulland no argument is passed for them
How to install or update PHPUnit 
v12.1.0: PHPUnit 12.1.0
Compare Source 
Added
- #6118: expectErrorLog()for expectingerror_log()output
- #6126: Attribute #[WithEnvironmentVariable]for setting an environment variable for the duration of a test
- The AfterTestMethodCalled,AfterTestMethodErrored,AfterTestMethodFinished,BeforeTestMethodCalled,BeforeTestMethodErrored,BeforeTestMethodFinished,PostConditionCalled,PostConditionErrored,PostConditionFinished,PreConditionCalled,PreConditionErrored, andPreConditionFinishedevent value objects now havetest()method that returns a value object representing the test method for which the hook method was called
Changed
- When code coverage processing is requested and no static analysis cache directory has been configured then a cache directory in the operating system's path used for temporary files is automatically created and used
- The static analysis of first-party source files required for the code coverage functionality is now performed before the first test is run, if code coverage processing is requested (via the XML configuration file and/or CLI options), all first-party source files are configured to be processed (which is the default), and a static analysis cache directory is available (either explicitly configured or automatically determined, see above). This has the same effect as running phpunit --warm-coverage-cachebefore running tests.
Deprecated
- #6140: The testClassName()method on theAfterTestMethodCalled,AfterTestMethodErrored,AfterTestMethodFinished,BeforeTestMethodCalled,BeforeTestMethodErrored,BeforeTestMethodFinished,PostConditionCalled,PostConditionErrored,PostConditionFinished,PreConditionCalled,PreConditionErrored, andPreConditionFinishedevent value objects (usetest()->className()instead)
How to install or update PHPUnit 
v12.0.10: PHPUnit 12.0.10
Compare Source 
Changed
- #6150: Reverted change introduced in PHPUnit 12.0.8
How to install or update PHPUnit 
v12.0.9: PHPUnit 12.0.9
Compare Source 
Fixed
- #6154: Method with()on test doubles yields error with static analyzer
How to install or update PHPUnit 
v12.0.8: PHPUnit 12.0.8
Compare Source 
Changed
- #6150: Trigger warning when code coverage analysis is performed and no cache directory is configured
How to install or update PHPUnit 
v12.0.7: PHPUnit 12.0.7
Compare Source 
Fixed
- #5976: TestDox result printer does not display details about errors triggered in before-first-test and after-last-test methods
How to install or update PHPUnit 
v12.0.6: PHPUnit 12.0.6
Compare Source 
Fixed
- #6142: $expectedand$actualare mixed up in failure description whenassertJsonFileEqualsJsonFile()fails
How to install or update PHPUnit 
v12.0.5: PHPUnit 12.0.5
Compare Source 
Fixed
- #6138: Test with failed expectation on value passed to mocked method is incorrectly considered risky
How to install or update PHPUnit 
v12.0.4: PHPUnit 12.0.4
Compare Source 
Fixed
- #6134: Missing event when child process ends unexpectedly
How to install or update PHPUnit 
v12.0.3: PHPUnit 12.0.3
Compare Source 
Changed
- TestCase::__construct()is now declared- final(it was annotated with- @finalbefore and the announced changed from- @finalto- finalfor PHPUnit 12 was forgotten)
Fixed
- #5951: Restore the includeUncoveredFilesconfiguration option
- #6133: Precision loss in aggregated test suite execution time(s) reported by JUnit XML logger
- A Test\PreparationFailedevent is now emitted in addition to aTest\Erroredevent when an unexpected exception is triggered in a before-test method
- A Test\Passedevent is no longer emitted in addition to aTest\FailedorTest\Erroredevent when an assertion failure or an unexpected exception is triggered in an after-test method
- A TestSuite\Finishedevent is now emitted when a before-first-test method errors
How to install or update PHPUnit 
v12.0.2: PHPUnit 12.0.2
Compare Source 
Changed
- Updated dependencies for PHAR distribution
How to install or update PHPUnit 
v12.0.1: PHPUnit 12.0.1
Compare Source 
Fixed
- Deprecation message for Assert::isType(),assertContainsOnly(),assertNotContainsOnly(), andcontainsOnly()
How to install or update PHPUnit 
v12.0.0: PHPUnit 12.0.0
Compare Source 
Added
- #5984: #[CoversClassesThatExtendClass]and#[UsesClassesThatExtendClass]
- #5985: #[CoversClassesThatImplementInterface]and#[UsesClassesThatImplementInterface]
- #6073: #[CoversNamespace]and#[UsesNamespace]
- #6074: #[RequiresEnvironmentVariable]
Changed
- #5872: The default value for shortenArraysForExportThresholdis now10(limit export of arrays to 10 levels) instead of0(do not limit export of arrays)
Deprecated
- #6053: Assert::isType()(was soft-deprecated in PHPUnit 11.5)
- #6056: assertContainsOnly()(was soft-deprecated in PHPUnit 11.5)
- #6056: assertNotContainsOnly()(was soft-deprecated in PHPUnit 11.5)
- #6060: containsOnly()(was soft-deprecated in PHPUnit 11.5)
Removed
- #5215: TestCase::iniSet()
- #5217: TestCase::setLocale()
- #5246: TestCase::createTestProxy()
- #5247: TestCase::getMockForAbstractClass()
- #5248: TestCase::getMockFromWsdl()
- #5249: TestCase::getMockForTrait()
- #5250: TestCase::getObjectForTrait()
- #5310: MockBuilder::enableAutoload()andMockBuilder::disableAutoload()
- #5311: MockBuilder::allowMockingUnknownTypes()andMockBuilder::disallowMockingUnknownTypes()
- #5312: MockBuilder::enableProxyingToOriginalMethods(),MockBuilder::disableProxyingToOriginalMethods(), andMockBuilder::setProxyTarget()
- #5313: MockBuilder::getMockForTrait()
- #5314: MockBuilder::getMockForAbstractClass()
- #5316: MockBuilder::enableArgumentCloning()andMockBuilder::disableArgumentCloning()
- #5321: MockBuilder::addMethods()
- #5416: Support for doubling interfaces (or classes) that have a method named method
- #5424: TestCasemethods for creating return stub configuration objects
- #5473: assertStringNotMatchesFormat()andassertStringNotMatchesFormatFile()
- #5536: Support for configuring expectations using expects()on test stubs
- #5541: Support for metadata in doc-comments
- #5710: Support for using comma-separated values with the --group,--exclude-group,--covers,--uses, and--test-suffixCLI options
- #5756: Support for the restrictDeprecationsattribute on the<source>element of the XML configuration file
- #5801: Support for targeting traits with #[CoversClass]and#[UsesClass]attributes
- #5978: Support for PHP 8.2
How to install or update PHPUnit 
v11.5.43: PHPUnit 11.5.43
Compare Source 
Changed
- Skipped tests alone no longer lead to a yellow background for the test result summary
Fixed
- #6391: Errors during backup of global variables and static properties are not reported
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v11.5.42: PHPUnit 11.5.42
Compare Source 
Fixed
- #6368: failOnPhpunitWarning="false"has no effect
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v11.5.41: PHPUnit 11.5.41
Compare Source 
- No changes; phpunit.pharrebuilt with updated dependencies
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v11.5.40: PHPUnit 11.5.40
Compare Source 
- No changes; phpunit.pharrebuilt with updated dependencies
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v11.5.39: PHPUnit 11.5.39
Compare Source 
Changed
- #6366: Exclude __sleep()and__wakeup()from test double code generation on PHP >= 8.5
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v11.5.38: PHPUnit 11.5.38
Compare Source 
Changed
- #6353: Disable performance optimization for tests requiring Xdebug
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v11.5.37: PHPUnit 11.5.37
Compare Source 
Changed
- Do not use __sleep()method (which will be deprecated in PHP 8.5)
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v11.5.36: PHPUnit 11.5.36
Compare Source 
Fixed
- #6340: Implicitly enabled display of deprecation details is not disabled when it should be
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
v11.5.35: PHPUnit 11.5.35
Compare Source 
Changed
- #[IgnorePhpunitDeprecations]is now considered for test runner deprecations (where applicable)
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
Compare Source 
v11.5.33: PHPUnit 11.5.33
Compare Source 
Changed
- #6321: Allow error_reporting=E_ALLfor--check-php-configuration
Fixed
- #5863: TestDox printer does not show previous exception
- #6102: expectUserDeprecationMessage*()fails when test is run in separate process
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
- You can follow @phpunit@phpc.social to stay up to date with PHPUnit's development.
- You can subscribe to the PHPUnit Updates newsletter to receive updates about and tips for PHPUnit.
 
Uh oh!
There was an error while loading. Please reload this page.
This PR contains the following updates:
^9.6->^12.0Release Notes
sebastianbergmann/phpunit (phpunit/phpunit)
v12.4.2: PHPUnit 12.4.2Compare Source
Changed
Fixed
Learn how to install or update PHPUnit 12.4 in the documentation.
Keep up to date with PHPUnit:
v12.4.1: PHPUnit 12.4.1Compare Source
Fixed
--filterformat used by PhpStorm stopped workingDataProviderMethodCalledevent value objectLearn how to install or update PHPUnit 12.4 in the documentation.
Keep up to date with PHPUnit:
v12.4.0: PHPUnit 12.4.0Compare Source
Added
#[IgnoreDeprecations]attributeDeprecated
#[RunClassInSeparateProcess]attributeLearn how to install or update PHPUnit 12.4 in the documentation.
Keep up to date with PHPUnit:
v12.3.15: PHPUnit 12.3.15Compare Source
Fixed
failOnPhpunitWarning="false"has no effectLearn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.14: PHPUnit 12.3.14Compare Source
phpunit.pharrebuilt with updated dependenciesLearn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.13: PHPUnit 12.3.13Compare Source
phpunit.pharrebuilt with updated dependenciesLearn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.12: PHPUnit 12.3.12Compare Source
phpunit.pharrebuilt with updated dependenciesLearn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.11: PHPUnit 12.3.11Compare Source
Changed
__sleep()and__wakeup()from test double code generation on PHP >= 8.5Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.10: PHPUnit 12.3.10Compare Source
Changed
E_DEPRECATEDissues when building the test suiteLearn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.9: PHPUnit 12.3.9Compare Source
Changed
__sleep()method (which will be deprecated in PHP 8.5)Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.8: PHPUnit 12.3.8Compare Source
Fixed
Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.7: PHPUnit 12.3.7Compare Source
Changed
#[IgnorePhpunitDeprecations]is now considered for test runner deprecations (where applicable)Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.6Compare Source
v12.3.5: PHPUnit 12.3.5Compare Source
Changed
error_reporting=E_ALLfor--check-php-configurationFixed
expectUserDeprecationMessage*()fails when test is run in separate processLearn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.4: PHPUnit 12.3.4Compare Source
Changed
--check-php-configurationFixed
ini_set('error_log')sets filepath outsideopen_basedirLearn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.3: PHPUnit 12.3.3Compare Source
Fixed
#[IgnorePhpunitDeprecations]is now considered for test runner deprecations" from PHPUnit 12.3.1)Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.2: PHPUnit 12.3.2Compare Source
Changed
testSplObjectStoragemethods that will be deprecated in PHP 8.5Learn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.1: PHPUnit 12.3.1Compare Source
Added
--check-php-configurationCLI option for checking whether PHP is configured for testingChanged
#[IgnorePhpunitDeprecations]is now considered for test runner deprecations (where applicable)Fixed
#[TestWith]or#[TestWithJson]attributes are now properly reportedDataProviderMethodFinishedevent is now also emitted when the provided data set has an invalid keyLearn how to install or update PHPUnit 12.3 in the documentation.
Keep up to date with PHPUnit:
v12.3.0: PHPUnit 12.3.0Compare Source
Added
#[IgnorePHPUnitWarnings]attribute for ignoring PHPUnit warnings#[TestDoxFormatter]and#[TestDoxFormatterExternal]attributes for configuring a custom TestDox formatter for tests that use data from data providersTestRunner\ChildProcessErroredeventConfiguration::includeTestSuites()andConfiguration::excludeTestSuites()Changed
@<data-set-name>format (compatible with--filterCLI option) in defect messages#[DataProvider*]attributes are mixed with#[TestWith*]attributesDeprecated
Configuration::includeTestSuite(), useConfiguration::includeTestSuites()insteadConfiguration::excludeTestSuite(), useConfiguration::excludeTestSuites()instead#[CoversNothing]on a test methodHow to install or update PHPUnit
v12.2.9: PHPUnit 12.2.9Compare Source
Fixed
fileattribute of<testClass>node of XML test list can be wrongHow to install or update PHPUnit
v12.2.8: PHPUnit 12.2.8Compare Source
Fixed
How to install or update PHPUnit
v12.2.7: PHPUnit 12.2.7Compare Source
Fixed
defects,randomconfiguration is supported by implementation, but it is not allowed by the XML configuration file schematestprefixHow to install or update PHPUnit
v12.2.6: PHPUnit 12.2.6Compare Source
Fixed
@no-named-argumentsleads to static analysis errors for variadic argumentsHow to install or update PHPUnit
v12.2.5: PHPUnit 12.2.5Compare Source
Fixed
<testsuite>element is missing requirednameattributeHow to install or update PHPUnit
v12.2.4: PHPUnit 12.2.4Compare Source
Changed
--include-git-informationCLI option or theincludeGitInformationattribute in the XML configuration fileHow to install or update PHPUnit
v12.2.3: PHPUnit 12.2.3Compare Source
Added
failOnPhpunitWarningattribute on the<phpunit>element of the XML configuration file and--fail-on-phpunit-warningCLI option for controlling whether PHPUnit should fail on PHPUnit warnings (default:true)--do-not-fail-on-deprecation,--do-not-fail-on-phpunit-warning,--do-not-fail-on-phpunit-deprecation,--do-not-fail-on-empty-test-suite,--do-not-fail-on-incomplete,--do-not-fail-on-notice,--do-not-fail-on-risky,--do-not-fail-on-skipped, and--do-not-fail-on-warningCLI options--do-not-report-useless-testsCLI option as a replacement for--dont-report-useless-testsDeprecated
--dont-report-useless-testsCLI option (use--do-not-report-useless-testsinstead)Fixed
ExpectationFailedExceptionHow to install or update PHPUnit
v12.2.2: PHPUnit 12.2.2Compare Source
Fixed
shortenArraysForExportThresholdXML configuration setting has no effect on all arrays exported for event-related value objectsHow to install or update PHPUnit
v12.2.1: PHPUnit 12.2.1Compare Source
Fixed
How to install or update PHPUnit
v12.2.0: PHPUnit 12.2.0Compare Source
Added
Experimental Support for Open Test Reporting XML
PHPUnit has supported reporting test results in the JUnit XML format for a long time. Unfortunately, there has never been a standard schema for the JUnit XML format. Common consumers of Clover XML log files interpret these files differently, which has led to frequent problems.
To address this, the JUnit team started the Open Test Reporting project, creating and maintaining language-agnostic XML and HTML test reporting formats. Unlike JUnit XML, Open Test Reporting's XML formats are extensible.
Logging in the Open Test Reporting XML format is controlled by the new
--log-otrCLI option and the new<otr>XML configuration element.This feature is experimental and the generated XML may change in order to enhance compliance with the Open Test Reporting project's XML schema definitions. The same applies to the XML schema definitions for information that is specific for PHP and PHPUnit. Please note that such changes may occur in bugfix or minor releases and could potentially break backwards compatibility.
Experimental Support for OpenClover XML
PHPUnit has supported reporting code coverage information in the Clover XML format for a long time. Unfortunately, there has never been a standard schema for the Clover XML format. Common consumers of Clover XML log files interpret these files differently, which leads to frequent problems.
The original commercial Clover project has been superseded by the Open Source OpenClover project, which provides an XML schema for its OpenClover XML format. Rather than modifying the existing Clover XML reporter to comply with the OpenClover XML schema, thereby breaking backward compatibility, a new OpenClover XML reporter has been introduced.
This new reporter is controlled by the new CLI option,
--coverage-openclover, and the new XML configuration element,<openclover>. This code coverage reporter generates XML documents that validate against the OpenClover project's XML schema definition, with one exception: the<testproject>element is not generated.The existing Clover XML reporter, controlled by the
--coverage-cloverCLI option and the<clover>XML configuration element, remains unchanged.This feature is experimental and the generated XML may change to enhance compliance with the OpenClover XML schema definition. Please note that such changes may occur in bugfix or minor releases and could potentially break backwards compatibility.
Miscellaneous
--with-telemetryCLI option that can be used together with--debugto print debugging information that includes telemetry informationTestCase::provideAdditionalInformation()method can now be used to emit aTest\AdditionalInformationProvidedeventTest\AfterLastTestMethodFailed,Test\AfterTestMethodFailed,Test\BeforeFirstTestMethodFailed,Test\BeforeTestMethodFailed,Test\PostConditionFailed,Test\PreConditionFailedevents are now emitted instead ofTest\AfterLastTestMethodErrored,Test\AfterTestMethodErrored,Test\BeforeFirstTestMethodErrored,Test\BeforeTestMethodErrored,Test\PostConditionErrored,Test\PreConditionErroredwhen theThrowableextendsAssertionFailedErrorto distinguish between errors and failures triggered in hook methodsTest\PreparationErroredevent is now emitted instead ofTest\PreparationFailedwhen theThrowabledoes not extendAssertionFailedErrorto distinguish between errors and failures triggered during test preparationTest\PreparationFailed::throwable()Changed
#[CoversNothing]and#[Covers*](or#[Uses*]) are used on a test class#[Covers*](or#[Uses*]) attribute is used multiple times on a test class#[Covers*]and#[Uses*]attributessetUp(), for example has a#[Test]attribute#[Small],#[Medium], or#[Large]is used on a test classHow to install or update PHPUnit
v12.1.6: PHPUnit 12.1.6Compare Source
Changed
createStubForIntersectionOfInterfaces()is called with a classHow to install or update PHPUnit
v12.1.5: PHPUnit 12.1.5Compare Source
Fixed
assertEmpty()andassertNotEmpty()use overly restrictivephpstan-assert emptydirectivesHow to install or update PHPUnit
v12.1.4: PHPUnit 12.1.4Compare Source
Added
displayDetailsOnAllIssuesattribute on the<phpunit>element of the XML configuration file and--display-all-issuesCLI option for controlling whether PHPUnit should display details on all issues that are triggered (default:false)failOnAllIssuesattribute on the<phpunit>element of the XML configuration file and--fail-on-all-issuesCLI option for controlling whether PHPUnit should fail on all issues that are triggered (default:false)Changed
E_STRICTconstantFixed
%aand%Amatches are not ignored from diff whenEXPECTFfailsHow to install or update PHPUnit
v12.1.3: PHPUnit 12.1.3Compare Source
Changed
memory_get_peak_usage()is now reset immediately before theTest\Preparedevent is emitted usingmemory_reset_peak_usage()so that (memory usage atTest\Finished- memory usage atTest\Prepared) is a better approximation of the memory usage of the testTelemetry\Infonow uses peak memory usage instead of memory usage (this affects--log-events-verbose-text)Fixed
error_log()is not displayed when test failsHow to install or update PHPUnit
v12.1.2: PHPUnit 12.1.2Compare Source
Fixed
How to install or update PHPUnit
v12.1.1: PHPUnit 12.1.1Compare Source
Fixed
willReturnMap()fails with nullable parameters when their default isnulland no argument is passed for themHow to install or update PHPUnit
v12.1.0: PHPUnit 12.1.0Compare Source
Added
expectErrorLog()for expectingerror_log()output#[WithEnvironmentVariable]for setting an environment variable for the duration of a testAfterTestMethodCalled,AfterTestMethodErrored,AfterTestMethodFinished,BeforeTestMethodCalled,BeforeTestMethodErrored,BeforeTestMethodFinished,PostConditionCalled,PostConditionErrored,PostConditionFinished,PreConditionCalled,PreConditionErrored, andPreConditionFinishedevent value objects now havetest()method that returns a value object representing the test method for which the hook method was calledChanged
phpunit --warm-coverage-cachebefore running tests.Deprecated
testClassName()method on theAfterTestMethodCalled,AfterTestMethodErrored,AfterTestMethodFinished,BeforeTestMethodCalled,BeforeTestMethodErrored,BeforeTestMethodFinished,PostConditionCalled,PostConditionErrored,PostConditionFinished,PreConditionCalled,PreConditionErrored, andPreConditionFinishedevent value objects (usetest()->className()instead)How to install or update PHPUnit
v12.0.10: PHPUnit 12.0.10Compare Source
Changed
How to install or update PHPUnit
v12.0.9: PHPUnit 12.0.9Compare Source
Fixed
with()on test doubles yields error with static analyzerHow to install or update PHPUnit
v12.0.8: PHPUnit 12.0.8Compare Source
Changed
How to install or update PHPUnit
v12.0.7: PHPUnit 12.0.7Compare Source
Fixed
How to install or update PHPUnit
v12.0.6: PHPUnit 12.0.6Compare Source
Fixed
$expectedand$actualare mixed up in failure description whenassertJsonFileEqualsJsonFile()failsHow to install or update PHPUnit
v12.0.5: PHPUnit 12.0.5Compare Source
Fixed
How to install or update PHPUnit
v12.0.4: PHPUnit 12.0.4Compare Source
Fixed
How to install or update PHPUnit
v12.0.3: PHPUnit 12.0.3Compare Source
Changed
TestCase::__construct()is now declaredfinal(it was annotated with@finalbefore and the announced changed from@finaltofinalfor PHPUnit 12 was forgotten)Fixed
includeUncoveredFilesconfiguration optionTest\PreparationFailedevent is now emitted in addition to aTest\Erroredevent when an unexpected exception is triggered in a before-test methodTest\Passedevent is no longer emitted in addition to aTest\FailedorTest\Erroredevent when an assertion failure or an unexpected exception is triggered in an after-test methodTestSuite\Finishedevent is now emitted when a before-first-test method errorsHow to install or update PHPUnit
v12.0.2: PHPUnit 12.0.2Compare Source
Changed
How to install or update PHPUnit
v12.0.1: PHPUnit 12.0.1Compare Source
Fixed
Assert::isType(),assertContainsOnly(),assertNotContainsOnly(), andcontainsOnly()How to install or update PHPUnit
v12.0.0: PHPUnit 12.0.0Compare Source
Added
#[CoversClassesThatExtendClass]and#[UsesClassesThatExtendClass]#[CoversClassesThatImplementInterface]and#[UsesClassesThatImplementInterface]#[CoversNamespace]and#[UsesNamespace]#[RequiresEnvironmentVariable]Changed
shortenArraysForExportThresholdis now10(limit export of arrays to 10 levels) instead of0(do not limit export of arrays)Deprecated
Assert::isType()(was soft-deprecated in PHPUnit 11.5)assertContainsOnly()(was soft-deprecated in PHPUnit 11.5)assertNotContainsOnly()(was soft-deprecated in PHPUnit 11.5)containsOnly()(was soft-deprecated in PHPUnit 11.5)Removed
TestCase::iniSet()TestCase::setLocale()TestCase::createTestProxy()TestCase::getMockForAbstractClass()TestCase::getMockFromWsdl()TestCase::getMockForTrait()TestCase::getObjectForTrait()MockBuilder::enableAutoload()andMockBuilder::disableAutoload()MockBuilder::allowMockingUnknownTypes()andMockBuilder::disallowMockingUnknownTypes()MockBuilder::enableProxyingToOriginalMethods(),MockBuilder::disableProxyingToOriginalMethods(), andMockBuilder::setProxyTarget()MockBuilder::getMockForTrait()MockBuilder::getMockForAbstractClass()MockBuilder::enableArgumentCloning()andMockBuilder::disableArgumentCloning()MockBuilder::addMethods()methodTestCasemethods for creating return stub configuration objectsassertStringNotMatchesFormat()andassertStringNotMatchesFormatFile()expects()on test stubs--group,--exclude-group,--covers,--uses, and--test-suffixCLI optionsrestrictDeprecationsattribute on the<source>element of the XML configuration file#[CoversClass]and#[UsesClass]attributesHow to install or update PHPUnit
v11.5.43: PHPUnit 11.5.43Compare Source
Changed
Fixed
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
v11.5.42: PHPUnit 11.5.42Compare Source
Fixed
failOnPhpunitWarning="false"has no effectLearn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
v11.5.41: PHPUnit 11.5.41Compare Source
phpunit.pharrebuilt with updated dependenciesLearn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
v11.5.40: PHPUnit 11.5.40Compare Source
phpunit.pharrebuilt with updated dependenciesLearn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
v11.5.39: PHPUnit 11.5.39Compare Source
Changed
__sleep()and__wakeup()from test double code generation on PHP >= 8.5Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
v11.5.38: PHPUnit 11.5.38Compare Source
Changed
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
v11.5.37: PHPUnit 11.5.37Compare Source
Changed
__sleep()method (which will be deprecated in PHP 8.5)Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
v11.5.36: PHPUnit 11.5.36Compare Source
Fixed
Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
v11.5.35: PHPUnit 11.5.35Compare Source
Changed
#[IgnorePhpunitDeprecations]is now considered for test runner deprecations (where applicable)Learn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
v11.5.34Compare Source
v11.5.33: PHPUnit 11.5.33Compare Source
Changed
error_reporting=E_ALLfor--check-php-configurationFixed
expectUserDeprecationMessage*()fails when test is run in separate processLearn how to install or update PHPUnit 11.5 in the documentation.
Keep up to date with PHPUnit:
v11.5.32: PHPUnit 11Configuration
📅 Schedule: Branch creation - Between 12:00 AM and 03:59 AM, only on Monday ( * 0-3 * * 1 ) (UTC), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.