NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #2527 most downloaded on Packagist
A set of Codeception modules to test WordPress projects.
Latest stable
4.7.2
Last release 2 months ago
26 Aug 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
422 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Added the backupGlobals, backupGlobalsExcludeList, backupStaticAttributes, backupStaticAttributesExcludeList to the WPLoader module configuration file
4.0.12
backupGlobals, backupGlobalsExcludeList, backupStaticAttributes, backupStaticAttributesExcludeList to the WPLoader module configuration file to provide a sweeping control over the state snapshot of test cases extending the WPTestCase class. Test cases overriding those properties explicitly will have their values respected.Correctly activate themes during bootstrap.
4.0.11
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Methods to set, delete, check and assert on the value of site and normal transients to the WPDb class.
4.0.10
WPDb class.MySqlDatabase class. (thanks @BrianHenryIE)Support database names up to 64 chars in the Database\MysqlDatabase class. (thanks @BrianHenryIE)
4.0.9
Database\MysqlDatabase class. (thanks @BrianHenryIE)Better exception message in the WordPress\WPConfigFile class when the processing fails. (thanks @BrianHenryIE)
4.0.8
WordPress\WPConfigFile class when the processing fails. (thanks @BrianHenryIE)Process\Protocol\Control that would cause tests to not run correctly outside of terminal. (thanks @BrianHenryIE)Rework the Core PHPUnit test case handling to correctly fire the test case set up and tear down methods.
4.0.7
Added back the amEditingUserWithId methood to the WPBrowser and WPWebDriver modules. (thanks @johnbillion for the original 3.1.7 contribution)
4.0.6
amEditingUserWithId methood to the WPBrowser and WPWebDriver modules. (thanks @johnbillion for the original 3.1.7 contribution)Set path correctly in WPWebDriver module setup
4.0.5
path correctly in WPWebDriver module setupUse Symphony Process component in loop code to solve Windows issues.
4.0.4
feat(Module/WPCLI) add changePath method by @lucatume in https://github.com/lucatume/wp-browser/pull/636
Full Changelog: https://github.com/lucatume/wp-browser/compare/4.0.2...4.0.3
changeWpcliPath method.Exclude some WooCommerce global values and static attributes from backup to avoid fatals.
4.0.2
Theme-related methods to the WPBrowser module.
4.0.1
WPBrowser module.WPWebDriver module.Deprecated the WPLoaer.activatePlugins parameter: the WPLoader.plugins parameter should be used instead.
4.0.0
WPLoader.stylesheet configuration parameter to allow specifying a distinct template and stylesheet.WPLoader.theme to WPLoader.template.WPLoader module:
dump - allows specifying one or more dump files to be loaded after the installation and before the first test runs.dbUrl - allows providing the db name, user, password and host using a single URL, e.g. mysql://user:password@host:port/db_name.AUTH_KEY - SECURE_AUTH_KEY - LOGGED_IN_KEY - NONCE_KEY - AUTH_SALT - SECURE_AUTH_SALT - LOGGED_IN_SALT - NONCE_SALT - allows specifying the WordPress salts.ABSPATH or wpRootFolderDB_NAME or dbNameDB_USER or dbUserDB_HOST or dbHostDB_PASSWORD or dbPasswordDB_CHARSET or dbCharsetDB_COLLATE or dbCollateWP_TESTS_MULTISITE or multisiteWP_DEFAULT_THEME or themeWP_TESTS_DOMAIN or domainWP_TESTS_EMAIL or adminEmailWP_TESTS_TITLE or titledbUrl configuration parameter to the WPDb module; it allows providing the database username, password and DSN with a single URL; e.g. mysql://user:password@host:port/db_name.WPCLI::dontSeeShellOutputMatches methodtad\WPBrowser namespace to the lucatume\WPBrowser one.Codeception namespace to the lucatume\WPBrowser one.lucatume\WPBrowser namespace to dedicated classes in the lucatume\WPBrowser\Utils
namespace.WPDb module scaffolding functions.Dotenv/Dotenv polyfill class.tad\WPBrowser functions related to Patchwork and PHPUnit.lucatume\WPBrowser Composer-related functions.tad\WPBrowser\pregErrorMessage function.WPLoader.isolatedInstall configuration parameter; installation always happens in isolation.WPLoaer.activatePlugins parameter: the WPLoader.plugins parameter should be used instead.tad\WPBrowser\processStatus, tad\WPBrowser\processReadPipe, tad\WPBrowser\process and tad\WPBrowser\buildCommandLine functions.isolatedInstall parameter from the WPLoader configuration: installation will always happen in isolation.mikey179/vfsStream development dependency.vria/nodiacritic dependency.wp-cli/wp-cli dependency.antecedent/patchwork dependency.dg/mysql-dump dependency.mikehaertl/php-shellcommand dependency.bordoni/phpass dependency, internalized the Hautelook\Phpass portable password hashing library.mikemclin/laravel-wp-password dependency.WordPress module and related support classes.StubProphecy and FunctionProphecy classes.WPHealthcheck class in favor of reports provided by the WordPress\Installation class.tad\WPBrowser\Utils\Map classWPLoader module configuration keys:
installationTableHandling - no more required.skipPluggables - no more required.wpDebug - the WP_DEBUG constant is always set to true during tests.activatePlugins - plugins specified in the plugins configuration key will be always activated.@runInSeparateProcess annotation.Copier and Symlinker extensions.WithWordPressFilters traitgenerate:wpajax command and related support classes.generate:wpcanonical command and related support classes.generate:wprest command and related support classes.generate:wprestcontroller command and related support classes.generate:wprestposttypecontroller command and related support classes.generate:wpxmlrpc command and related support classes.WPCLI module to use the Symfony\Component\Process\Process class under the hood.preserveGlobalState test method support to reimplement support later.WPCLI module to use supported configuration parameters as strict arguments by defaultRun the integration suite in CI: it was never part of the workflow matrix, so the only tests covering the scaffold templates, the WPLoader bootstrap a
3.8.2
integration suite in CI: it was never part of the workflow matrix, so the only tests covering the scaffold templates, the WPLoader bootstrap and the WordPress installation API went unchecked on every pull request (#821).init, and the scaffold snapshot tests normalize WORDPRESS_VERSION so a new WordPress release does not break them (#819, #821). (thanks @jonwaldstein)__3.5__) snapshots of the scaffold, WP-CLI module and scaffolded-installation tests moved to tests/integration along with their test classes: left behind under tests/unit by the previous transpile, they were re-created on every run instead of being compared (#821).Transpile the v4 unreleased changes (test suite split, dead-code removal, MysqlServerController port reuse, parallel-run fixes, Utils\Filesystem deleg
3.8.1
MysqlServerController port reuse, parallel-run fixes, Utils\Filesystem delegation to symfony/filesystem) down to the PHP 7.1-compatible v3.5 line (#817).Transpile the v4 changes from 4.6.0 to 4.7.1 down to the PHP 7.1-compatible v3.5 line (#810).
3.8.0
Doc-block of wpimport command (thanks @sc0ttkclark).
3.7.19
wp:db:import command (thanks @sc0ttkclark).Transpiled code issues causing fatal errors.
3.7.18
Snapshot resolved config in WPFilesystem::_initialize() to preserve absolute paths across tests when _resetConfig() or _reconfigure() is called.
3.7.17
WPFilesystem::_initialize() to preserve absolute paths across tests when _resetConfig() or _reconfigure() is called.setAccessible() Reflection method calls with a PHP_VERSION_ID check to skip the no-op call on PHP >= 8.1. (thanks @BrianHenryIE)2.2.14 to version 2.2.17Wording in the default EndToEnd suite configuration files to reflect the nature of the suite.
3.7.16
WPLoader module to ensure pluggable functions overridden in plugins will correctly apply.DB_PASSWORD constant not being defined when dbPassword configuration parameter is set to an empty string in WPLoader module, fixes #786.Updated activatePlugin and deactivatePlugin methods in WPBrowser and WPWebDriver modules to reload the plugins page after activation.
3.7.15
activatePlugin and deactivatePlugin methods in WPBrowser and WPWebDriver modules to reload the plugins page after activation.Updated activatePlugin and deactivatePlugin methods in WPBrowser and WPWebDriver modules to use WordPress 6.5+ compatible selectors
3.7.14
activatePlugin and deactivatePlugin methods in WPBrowser and WPWebDriver modules to use WordPress 6.5+ compatible selectorsWPLoader module output in exceptions (thanks @BrianHenryIE).The WPLoader module will now attempt resolving the WP_CONTENT_DIR, WP_PLUGIN_DIR, WPMU_PLUGIN_DIR and pluginsFolder configuration parameters from the
3.7.13
WPLoader module will now attempt resolving the WP_CONTENT_DIR, WP_PLUGIN_DIR, WPMU_PLUGIN_DIR and
pluginsFolder configuration parameters from the Codeception root directory if not possible to resolve them from the
current working directory. (thanks @BrianHenryIE)allow-root configuration parameter in the WPCLI module.Symlinker extension issue where the target link path would be built incorrectly.Avoid duplicated definition issue in GenerateWPUnit command.
3.7.12
GenerateWPUnit command.Ensure plugin activation is respected indifferent of plugins that might deactivate others during activation.
3.7.11
Check the PID file for the PHP built-in server, MySQL and Chromedriver controllers to make sure the PID maps to an actually running process.
3.7.10
WPConfigFile class.Support custom binaries for WP-CLI in the WPCLI module.
3.7.9
WPCLI module.In WPDb module look up the WPFilesystem module with and without leading slash.
3.7.8
WPDb module look up the WPFilesystem module with and without leading slash.Fallback for missing $_composer_autoload_path file. (thanks @andronocean)
3.7.7
$_composer_autoload_path file. (thanks @andronocean)Improve LoadSandbox error and messaging (used by the WPLoader module when loadOnly: true) around Codeception early exits. (thanks @andronocean)
3.7.6
LoadSandbox error and messaging (used by the WPLoader module when loadOnly: true) around Codeception early exits. (thanks @andronocean)Set proper WPTetCase::factory() return type, so IDE autocompletion works (thanks @defunctl).
3.7.5
WPTetCase::factory() return type, so IDE autocompletion works (thanks @defunctl).Ensure the WPLoader module will set the db constants when in loadOnly: true mode.
3.7.4
WPLoader module will set the db constants when in loadOnly: true mode.WPLoader module will now set the WPBROWSER_LOAD_ONLY environment variable to 1 when in loadOnly: true and to 0 when in loadOnly: false mode.WPLoader module to explicitly state that the configFlile parameter will be used both when in loadOnly: true and loadOnly: false modes.Doc-block namespace in the WPRestApiTestCase class, thanks @TimothyBJacobs.
3.7.3
WPRestApiTestCase class, thanks @TimothyBJacobs.WPLoader::_beforeSuite method signature to avoid breaking compatibility with Codeception 4.x.
3.7.2
WPLoader::_beforeSuite method signature to avoid breaking compatibility with Codeception 4.x.mysql command output in the MysqlServerController information output.
3.7.1
mysql command output in the MysqlServerController information output.The MysqlServerController extension.
3.7.0
MysqlServerController extension.WPLoader module will initialize correctly when used in loadOnly mode not using the EventDispatcherBridge extension. (thanks @lxbdr)wpdb class from either the class-wpdb.php file or the wp-db.php one, supporting older versions of WordPress (thanks @BrianHenryIE)WPLoader configuration parameters correctly.WPTestCase class, remove attachments created during tests between tests.Updated documentation entry in EndToEnd suite bootstrap file.
3.6.5
Re-added the Symlinker extension to allow for the symlinking of plugins and themes in place during tests.
Symlinker extension to allow for the symlinking of plugins and themes in place during tests.Symlinker extension.Disable strict connection ID check for SQLite databases to avoid errors in tests.
3.6.3
Better messaging when throwing due to disconnected database.
3.6.2
WPLoader::beStrictAboutWpdbConnectionId configuration parameter, defaults to true, to throw if db connection changes during setup before class.Throw on disconnected db in WPTestCase::setUpBeforeClass; iterates over the fix for #720.
3.6.1
WPTestCase::setUpBeforeClass; iterates over the fix for #720.Allow plugins to be loaded from arbitrary absolute or relative paths in the WPLoader module.
3.6.0
WPLoader module.WPLoader module.theme configuration parameter in the WPLoader module to define [parent-theme, child-theme] pairs.Nothing published for this version
Updated sqlite-integration-plugin and Core PHPUnit suite files.
3.5.8
sqlite-integration-plugin and Core PHPUnit suite files.Fix non standard installation handling, hello Bedrock!
3.5.7
Load WordPress at SUITE_BEFORE in the WPLoader module, I had previously changed this to SUITE_INIT but that was causing issues.
3.5.6
SUITE_BEFORE in the WPLoader module, I had previously changed this to SUITE_INIT but that was causing issues.Update init template to scaffold dump file path and example tests correctly (thanks @tarecord).
3.5.5
Update the build script to target the correct branch.
3.5.4
The AirplaneMode module, based on the norcross/airplane-mode plugin, to put the website under test in "airplane mode", preventing it from making any n
3.5.3
AirplaneMode module, based on the norcross/airplane-mode plugin, to put the website under test in "airplane mode", preventing it from making any network requests during tests.lucatume\WPBrowser\Traits\UopzFunctions trait to provide a set of functions to work with the uopz extension; see the documentation for more details.
3.5.2
lucatume\WPBrowser\Traits\UopzFunctions trait to provide a set of functions to work with the uopz extension; see the documentation for more details.Refactor MysqlDatabase class following merge of #702.
3.5.1
MysqlDatabase class following merge of #702.First release of the v3.5 branch built from the transpile of the v4 branch.
v3.5 branch built from the transpile of the v4 branch.move wp-cli/wp-cli-bundle from require-dev to require to restore pre-existing support
3.2.3
wp-cli/wp-cli-bundle from require-dev to require to restore pre-existing supportSupport for the activatePluginsSilently configuration parameter in the WPLoader module to activate plugins without firing the activated_plugin hook.
3.2.2
activatePluginsSilently configuration parameter in the WPLoader module to activate plugins without firing the activated_plugin hook.Ensure _before and _after methods are called correctly by WPTestCase.
3.2.1
_before and _after methods are called correctly by WPTestCase.Drop support for Codeception version 2 and 3; starting from this version, the v3 version of the project will only support Codeception version 4.
v3 version of the project will only support Codeception version 4.WPBrowser module.WPWebDriver module.Removed the lucatume\WPBrowser\Traits\WithForks trait.
3.1.10
lucatume\WPBrowser\Traits\WithForks trait.after_switch_theme action in the WPLoader module.If possible, load the wpdb class from the wp-includes/class-wpdb.php file on newer versions of WordPress.
3.1.9
wpdb class from the wp-includes/class-wpdb.php file on newer versions of WordPress.Clean up and update the build and stack.
3.1.8
.gitattributes to remove more files.Inheritance of current env if the env key is set in the configuration of the WPCLI module (thanks @calvinalkan).
3.1.7
env key is set in the configuration of the WPCLI module (thanks @calvinalkan).WPLoader::_swithchTheme method.WPCLI::cli() method. (thanks @calvinalkan).haveInShellEnvironment and dontInheritShellEnvironment methods to the WPCLI module. (thanks @calvinalkan).amEditingUserWithId method to the WPBrowser and WPWebDriver modules. (thanks @johnbillion).One column per quarter.