All notable changes to this project will be documented in this file.
This projects adheres to Keep a CHANGELOG and uses Semantic Versioning.
Nothing yet.
1.1.2 - 2024-09-07
This is a maintenance release.
- README: updated sub-section about PHPUnit version support with information about the PHPUnit Polyfills 3.x branch. PR #188
- General housekeeping.
1.1.1 - 2024-04-05
- Compatibility fix for running tests using a PHPUnit PHAR file for PHPUnit 8.5.38+ and PHPUnit 9.6.19+. PR #161.
- General housekeeping.
1.1.0 - 2023-08-19
Yoast\PHPUnitPolyfills\Polyfills\AssertObjectProperty
trait to polyfill theAssert::assertObjectHasProperty()
andAssert::assertObjectNotHasProperty()
methods as backported from PHPUnit 10.1.0 to PHPUnit 9.6.11. PR #135.
- General housekeeping.
1.0.5 - 2023-03-31
- A custom
$message
parameter passed to an assertion, will no longer overrule an emulated "assertion failed" message, but will be prefixed to it instead. PR #97 This applies to the following polyfills:assertIsClosedResource()
assertIsNotClosedResource()
assertIsReadable()
assertNotIsReadable()
assertIsWritable()
assertNotIsWritable()
assertDirectoryExists()
assertDirectoryNotExists()
assertStringNotContainsString()
assertStringNotContainsStringIgnoringCase()
- The
develop
branch has been removed. Development will now take place in the1.x
and2.x
branches. - README: links to the PHPUnit manual now point explicitly to the PHPUnit 9.x documentation. PR #94
- README: new sub-section about PHPUnit version support. PR #99
- README: various minor improvements. PRs #92, #93
- General housekeeping.
1.0.4 - 2022-11-16
This is a maintenance release.
- The
Yoast\PHPUnitPolyfills\Autoload
class is nowfinal
. PR #77. - README: clear up minor language confusion. Props Phil E. Taylor and fredericgboutin-yapla for pointing it out.
- README: fix links which were broken due to an upstream branch rename. PR #80.
- Verified PHP 8.2 compatibility.
- General housekeeping.
1.0.3 - 2021-11-23
- General housekeeping.
- The failure message thrown for the
assertIsClosedResource()
andassertIsNotClosedResource()
assertions will now be more informative, most notably, when the value under test is a closed resource. PR #65, props Alain Schlesser for reporting.
1.0.2 - 2021-10-03
As of version 2.15.0 of the shivammathur/setup-php
action for GitHub Actions, the PHPUnit Polyfills can be installed directly from this action using the tools
key.
- README: FAQ section about installing and using the library via the
shivammathur/setup-php
action. PR #52
- README: minor textual clarifications and improvements. PRs #52, #54, props Pierre Gordon.
- General housekeeping.
- Autoloader: improved compatibility with packages which create a
class_alias
for thePHPUnit_Runner_Version
orPHPUnit\Runner\Version
class. PR #59
1.0.1 - 2021-08-09
- The
Yoast\PHPUnitPolyfills\Autoload
class now contains aVERSION
constant. Issue #46, PR #47, props Pascal Birchler for the suggestion. This version constant can be used by (complex) test setups to verify that the PHPUnit Polyfills which will be loaded, comply with the version requirements for the test suite.
- Minor documentation updates. #43
1.0.0 - 2021-06-21
Yoast\PHPUnitPolyfills\Polyfills\AssertClosedResource
trait to polyfill theAssert::assertIsClosedResource()
andAssert::assertIsNotClosedResource()
methods as introduced in PHPUnit 9.3.0. PR #27.Yoast\PHPUnitPolyfills\Polyfills\AssertObjectEquals
trait to polyfill theAssert::assertObjectEquals()
method as introduced in PHPUnit 9.4.0. PR #38. The behaviour of the polyfill closely matches the PHPUnit native implementation, but is not 100% the same. Most notably, the polyfill will check the type of the returned value from the comparator method instead of enforcing a return type declaration for the comparator method.Yoast\PHPUnitPolyfills\Polyfills\EqualToSpecializations
trait to polyfill theAssert::equalToCanonicalizing()
,Assert::equalToIgnoringCase()
andAssert::equalToWithDelta()
methods as introduced in PHPUnit 9.0.0. PR #28, props Marc Siegrist.- Polyfills for the PHP native
Error
andTypeError
classes as introduced in PHP 7.0. PR #36. - README: FAQ section covering functionality removed from PHPUnit and usage with a Phar.
- The minimum supported PHP version has been lowered to PHP 5.4 (was 5.5). PR #19.
XTestCase
: the visibility of thesetUpFixtures()
and thetearDownFixtures()
methods has been changed toprotected
(waspublic
). Issue #10, PR #20, props Mark Baker for reporting.- README: re-ordered the sections and various other improvements.
- Initial preparation for PHPUnit 10.0 compatibility.
- General housekeeping.
- Issue #17 via PR #18 -
AssertStringContainString
: PHPUnit < 6.4.2 would throw a "mb_strpos(): empty delimiter" PHP warning when the$needle
passed was an empty string. Props Gary Jones.
0.2.0 - 2020-11-25
Yoast\PHPUnitPolyfills\TestListeners\TestListenerDefaultImplementation
: a cross-version compatible base implementation forTestListener
s using snake_case method names to replace the PHPUnit native method names.Yoast\PHPUnitPolyfills\Helpers\AssertAttributeHelper
trait containing agetProperty()
and agetPropertyValue()
method. This is a stop-gap solution for the removal of the PHPUnitassertAttribute*()
methods in PHPUnit 9. It is strongly recommended to refactor your tests/classes in a way that protected and private properties no longer be tested directly as they should be considered an implementation detail. However, if for some reason the value of protected or private properties still needs to be tested, this helper can be used to get access to their value.Yoast\PHPUnitPolyfills\Polyfills\AssertNumericType
trait to polyfill theAssert::assertFinite()
,Assert::assertInfinite()
andAssert::assertNan()
methods as introduced in PHPUnit 5.0.0.Yoast\PHPUnitPolyfills\Polyfills\ExpectException
trait to polyfill theTestCase::expectException()
,TestCase::expectExceptionMessage()
,TestCase::expectExceptionCode()
andTestCase::expectExceptionMessageRegExp()
methods, as introduced in PHPUnit 5.2.0 to replace theTestcase::setExpectedException()
and theTestcase::setExpectedExceptionRegExp()
method.Yoast\PHPUnitPolyfills\Polyfills\AssertFileDirectory
trait to polyfill theAssert::assertIsReadable()
,Assert::assertIsWritable()
methods and their file/directory based variations, as introduced in PHPUnit 5.6.0.Yoast\PHPUnitPolyfills\TestCases\TestCase
: support for theassertPreConditions()
andassertPostConditions()
methods.
- The minimum supported PHP version has been lowered to PHP 5.5 (was 5.6).
- The minimum supported PHPUnit version has been lowered to PHP 4.8.36 (was 5.7). Note: for PHPUnit 4, only version 4.8.36 is supported, for PHPUnit 5, only PHPUnit >= 5.7.21 is supported.
- Readme: documentation improvements.
0.1.0 - 2020-10-26
Initial release.