Skip to content

2.0.0

Compare
Choose a tag to compare
@jrfnl jrfnl released this 06 Jun 20:30
· 266 commits to main since this release
c758753

PHPUnit 10 support

This release updates the PHPUnit Polyfills to allow for "writing your tests for PHPUnit 10 and running them all the way back to PHPUnit 5".

Please keep in mind that the PHPUnit Polyfills provide forward-compatibility. This means that features which PHPUnit no longer supports in PHPUnit 10.x, like expecting PHP deprecation notices or warnings, are also no longer supported in the 2.0 release of the PHPUnit Polyfills.

Please refer to the PHPUnit 10 release notification and PHPUnit 10 changelog to inform your decision on whether or not to upgrade (yet).

Projects which don't use any of the new or removed functionality in their test suite, can, of course, use the PHPUnit Polyfills 1.x and 2.x series side-by-side, like so composer require --dev yoast/phpunit-polyfills:"^1.0 || ^2.0".

⚠️ Important: about the TestListener polyfill ⚠️

The TestListener polyfill in PHPUnit Polyfills 2.0 is not (yet) compatible with PHPUnit 10.0.0.

If you need the TestListener polyfill, it is recommended to stay on the PHPUnit Polyfills 1.x series for the time being and to watch the related ticket.

Changelog

Added

  • Yoast\PHPUnitPolyfills\Polyfills\AssertIgnoringLineEndings trait to polyfill the Assert::assertStringEqualsStringIgnoringLineEndings() and the Assert::assertStringContainsStringIgnoringLineEndings() methods as introduced in PHPUnit 10.0.0. PR #109.
  • Yoast\PHPUnitPolyfills\Polyfills\AssertIsList trait to polyfill the Assert::assertIsList() method as introduced in PHPUnit 10.0.0. PR #110.
  • Yoast\PHPUnitPolyfills\Polyfills\AssertObjectProperty trait to polyfill the Assert::assertObjectHasProperty() and the Assert::assertObjectNotHasProperty() methods as introduced in PHPUnit 10.1.0. PR #116.

Changed

  • Composer: allow for installation of PHPUnit 10.x. PR #130
  • Nearly all assertion methods are now final. This alignes them with the same change made upstream in PHPUnit 10.0.0. PR #104.
  • General housekeeping.

Removed

  • Support for PHP < 5.6. PR #102.
  • Support for PHPUnit < 5.7.21. PR #102.
  • Support for expecting PHP deprecations, notices, warnings and error via the Yoast\PHPUnitPolyfills\Polyfills\ExpectPHPException trait. PR #108.
    The trait has been removed completely as PHPUnit 10 no longer supports this functionality.
  • The Yoast\PHPUnitPolyfills\Polyfills\AssertNumericType trait which is no longer needed now support for PHPUnit < 5.7 has been dropped. PR #102.
  • The Yoast\PHPUnitPolyfills\Polyfills\ExpectException trait which is no longer needed now support for PHPUnit < 5.7 has been dropped. PR #102.
  • The Yoast\PHPUnitPolyfills\Polyfills\AssertFileDirectory trait which is no longer needed now support for PHPUnit < 5.7 has been dropped. PR #102.