Changelog

December 2, 2025 ยท View on GitHub

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.1.1 - 2025-12-03

Fixed

  • Address PHP deprecation warnings about implicitly nullable parameters
  • Allow onFilter(...)->withAnyArgs() to be used multiple times on a single tests

1.1.0 - 2025-03-11

Added

  • Add support for types in expectFilter() mocks
  • Add support for withAnyArgs() method for onFilter() calls

Fixed

  • Prevent IDEs/phpstan from detecting exceptions in mocked functions that don't actually throw in WordPress core (e.g. esc_html())
  • Typos in docs and function name (old function iExcpectWhenIRun() still exists but has been deprecated)

1.0.1 - 2024-01-04

Changed

  • Updated WP_Mock::expectHookNotAdded() with new params
  • Updated PHP dependencies to ensure compatibility with PHP 8.3

1.0.0 - 2023-07-24

Added

  • Added and documented return types in codebase
  • New AccessInaccessibleClassMembers helpers in test case
  • Move documentation to GitBook

Changed

  • Require PHP 7.4
  • Update dependencies (Mockery 1.6, PHPUnit 9.6)
  • Remove deprecated methods in WP_Mock main class
  • Update Hook::safe_offset() to handle closure

Fixed

  • IsEqualHtml extends PHPUnit Constraint
  • Improve responder handling of closures

0.5.0 - 2022-11-01

Added

  • New AnyInstance matcher

Changed

  • Add compatibility with PHPUnit 9
  • Require PHP 7.3
  • Mocker function for _n() to evaluate singular or plural

Fixed

  • Patchwork not loaded error (WP_Mock::setUsePatchwork(true) was broken)
  • Address call to undefined method getAnnotations error from test class
  • Support for latest PHPUnit versions

0.4.2 - 2019-03-15

Added

  • Minor Filter/Action/Hook Assertion Bugfix
  • Please note: As with the previously-tagged release, this is not necessarily a stable release!

0.4.1 - 2019-02-26

Added

  • PHPUnit 8 Compatibility
  • This release brings us up to date with the latest release of PHPUnit.
  • Please note: As with the previously-tagged release, this is not necessarily a stable release!

0.4.0 - 2019-01-16

Added

  • PHPUnit 7 Compatibility
  • This release brings us up to date both with PHPUnit and with PHP itself. The minimum version of PHP now supported by the project is 7.1.
  • Please note: As with the previously-tagged release, this is not necessarily a stable release!

0.3.0 - 2017-12-03

Added

  • This release brings us up to date both with PHPUnit and with PHP itself. The minimum version of PHP now supported by the project is 7.0.
  • Please note: As with the previously-tagged release, this is not necessarily a stable release!

0.2.0 - 2017-07-18

Added

  • Unstable Distributable Release
  • This release moves to using static, tagged versions hosted on Packagist. Aside from a handful of bugfixes, it's equivalent to the dev-dev version many have been using before July 2017. Moving forward, all versions will be static and tagged.
  • Please note: As with the previously-tagged release, this is not a stable release! We strongly encourage you to use the 1.0.x-dev source release until we release a stable 1.0 version.

0.1.1 - 2015-03-31

Added

  • Better documentation and phpDocumentor output

0.1.0 - 2014-12-30

Added

  • Unstable Distributable Release
  • Currently, we only have source releases on Packagist (dev-trunk and 1.0.x-dev). This will be a distributable release that will allow local caching of the library so that not every use needs to be a git clone.
  • Please note: this is not a stable release! We strongly encourage you to use the 1.0.x-dev source release until we release a stable 1.0 version.