PackageTrack
Sign in Get early access

automattic/wordbless

WorDBless allows you to use WordPress core functions in your PHPUnit tests without having to set up a database and the whole WordPress environment

0.6.1 7.5M downloads/mo #2158 most downloaded on Packagist Automattic/wordbless

What this package is like to depend on

Last release 5 days ago

18 Aug 2026

Release timing varies

gaps range from 3 weeks to 1.9 years

Most releases are documented

notes for 10 of 13 stable releases

Nothing withdrawn

no release was ever pulled

6 years old

13 releases · first in 2020

1 release in the last 12 months

see the full history below

Release timeline

13 releases · Sep 2020 to Aug 2026
2021 2022 2023 2024 2025 2026
Release Pre-release

Releases

latest 13
  1. 0.6.1 18 Aug 2026
    Release notes

    What's Changed

    • Bump phpunit/phpunit from 9.6.22 to 9.6.33 by @dependabot[bot] in #82
    • Add AGENTS.md and clear UserMeta between tests by @kraftbj in #83
    • Load: Define ABSPATH before SQLite cleanup and scope cleanup to sqlite engine by @kraftbj in #85
    • Allow WordPress 7.0 in roots/wordpress constraint by @kraftbj in #84
    • Use Composer event object to determine WordPress installation path. by @zinigor in #86
    • chore: pin third-party GitHub Actions to commit SHAs by @mahangu in #89
    • Bump composer/composer from 2.9.7 to 2.10.2 by @dependabot[bot] in #91
    • Bump the actions-major group with 2 updates by @dependabot[bot] in #90
    • Fix: minor grammatical issues in README.md by @mehrazmorshed in #87
    • CI: Fix flaky composer-normalize step and pin WordPress version legs by @kraftbj in #92

    WordPress 7.0 support

    The roots/wordpress constraint is now ^6.6 || ^7.0, so projects using WorDBless can run their tests against WordPress 7.0. This is the headline change: 0.6.0 capped you at WordPress 6.x, and the widened constraint has been sitting on trunk untagged since February.

    CI now runs all three test suites against pinned WordPress 6.6 and 7.0 legs in addition to the lowest/locked/highest matrix, so neither major loses coverage when the next one ships.

    Other notes

    Metadata for users is now cleared between tests, matching what already happened for options, posts, post meta, and users. If a test relied on user meta surviving from one test method to the next, it will need to set that meta up explicitly.

    WorDBless\Composer\InstallDropin::copy() now takes the Composer Event object and reads extra.wordpress-install-dir from the root package, so a custom WordPress install directory gets the db.php drop-in in the right place. Used as documented, as a post-install-cmd and post-update-cmd script handler, this needs no change on your side. Any code calling InstallDropin::copy() directly will need to pass the event.

    The SQLite cleanup in Load::load() only runs for the sqlite engine now, and ABSPATH is defined before it runs.

    New Contributors

    Full Changelog: 0.6.0...0.6.1

    Open source →
  2. 0.6.0 22 Apr 2025
    Release notes

    What's Changed

    • Experimental: Add support for SQLite by @kraftbj in #74

    This allows WorDBless to work in two modes -- no database (default) or with SQLite by passing an argument to the Load::init() function. This uses the SQLite implementation plugin being developed for potential Core inclusion. A known issue is that the SQLite plugin does not expect to be used for new installs without an existing MySQL database, so the first run of using SQLite will emit some noise about the DB not being found until it switches over to attempting SQLite.

    Full Changelog: 0.5.3...0.6.0

    Open source →
  3. 0.5.3 15 Apr 2025
    Release notes

    What's Changed

    • Fix get_metadata( $single = true ) when the default is an array by @anomiex in #79

    Full Changelog: 0.5.2...0.5.3

    Open source →
  4. 0.5.2 15 Apr 2025
    Release notes

    What's Changed

    • Metadata: Fix return value for Metadata::get when $single is true by @manzoorwanijk in #77
    • Fix warning with WordPress 6.8 by @anomiex in #78

    New Contributors

    Full Changelog: 0.5.1...0.5.2

    Open source →
  5. 0.5.1 26 Mar 2025
    Release notes

    What's Changed

    • BaseTestCase: Add attributes for PHPUnit 11+ by @anomiex in #75

    Full Changelog: 0.5.0...0.5.1

    Open source →
  6. 0.5.0 12 Feb 2025
    Release notes

    What's Changed

    New Contributors

    Full Changelog: 0.4.2...0.5.0

    Open source →
  7. 0.4.2 15 Mar 2023
    Release notes

    What's Changed

    New Contributors

    Full Changelog: 0.4.1...0.4.2

    Open source →
  8. 0.4.1 03 Oct 2022
    Release notes

    What's Changed

    • Use TAB characters in README by @szepeviktor in #57
    • Fix failing test under PHP8 and provide a fallback value for string by @cezarpopa in #59

    New Contributors

    Full Changelog: 0.4.0...0.4.1

    Open source →
  9. 0.4.0 14 Sep 2022
    Release notes

    The package that WorDBless pulls WordPress updated their process to no longer ship the wp-content directory, which means no longer will all the default themes from Twenty Ten onward will be downloaded!

    The downside is this breaks the historical way WorDBless is installed.

    When updating to 0.4.0, you will need to update your package's composer.json to use the new command:

    "scripts": {
            "post-install-cmd": "WorDBless\\Composer\\InstallDropin::copy",
    	"post-update-cmd": "WorDBless\\Composer\\InstallDropin::copy"
        },
    

    Thanks to @oskosk, @lhkowalski, and @dkmyta for the original report.

    What's Changed

    New Contributors

    Full Changelog: 0.3.1...0.4.0

    Open source →
  10. 0.3.1 07 Jul 2021
    Release notes

    Fixes update_option for default options and fix wp_untrash_post tests for WordPress 5.6

    Open source →
  11. 0.3.0 02 Dec 2020

    Nothing published for this version

  12. 0.2.0 01 Dec 2020

    Nothing published for this version

  13. 0.1.0 16 Sep 2020

    Nothing published for this version

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive