Sourced from phpunit/phpunit's releases.

PHPUnit 12.2.1

Fixed

• #6228: Variadic test methods should not warn about too many arguments from data provider

---

How to install or update PHPUnit

PHPUnit 12.2.0

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-telemetry CLI option that can be used together with --debug to print debugging information that includes telemetry information
• The TestCase::provideAdditionalInformation() method can now be used to emit a Test\AdditionalInformationProvided event
• The new Test\AfterLastTestMethodFailed, Test\AfterTestMethodFailed, Test\BeforeFirstTestMethodFailed, Test\BeforeTestMethodFailed, Test\PostConditionFailed, Test\PreConditionFailed events are now emitted instead of Test\AfterLastTestMethodErrored, Test\AfterTestMethodErrored, Test\BeforeFirstTestMethodErrored, Test\BeforeTestMethodErrored, Test\PostConditionErrored, Test\PreConditionErrored when the Throwable extends AssertionFailedError to distinguish between errors and failures triggered in hook methods
• The new Test\PreparationErrored event is now emitted instead of Test\PreparationFailed when the Throwable does not extend AssertionFailedError to 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

... (truncated)

Sourced from phpunit/phpunit's changelog.

[12.2.1] - 2025-06-07

Fixed

• #6228: Variadic test methods should not warn about too many arguments from data provider

[12.2.0] - 2025-06-06

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-telemetry CLI option that can be used together with --debug to print debugging information that includes telemetry information
• The TestCase::provideAdditionalInformation() method can now be used to emit a Test\AdditionalInformationProvided event
• The new Test\AfterLastTestMethodFailed, Test\AfterTestMethodFailed, Test\BeforeFirstTestMethodFailed, Test\BeforeTestMethodFailed, Test\PostConditionFailed, Test\PreConditionFailed events are now emitted instead of Test\AfterLastTestMethodErrored, Test\AfterTestMethodErrored, Test\BeforeFirstTestMethodErrored, Test\BeforeTestMethodErrored, Test\PostConditionErrored, Test\PreConditionErrored when the Throwable extends AssertionFailedError to distinguish between errors and failures triggered in hook methods
• The new Test\PreparationErrored event is now emitted instead of Test\PreparationFailed when the Throwable does not extend AssertionFailedError to 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

... (truncated)

• 5f09fda Prepare release
• 3835bb7 Fix
• b40ffc1 Update ChangeLog
• f3a4b34 Fix variadic methods to not warn about too many arguments from data provider
• 70b6669 Extend tests to verify that variadic methods do not warn about too many argum...
• f3f6587 Prepare release
• 7ae1db9 Merge branch '11.5'
• 4cd72fa Prepare release
• f9d8fef Merge branch '12.1'
• c887a5a Update tools
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)