emeraldjava/wordpress-tests-core

WordPress core PHPUnit test library

WordPress Tests Core

WordPress Core PHPUnit Test Library made installable via Composer! Note the module will load the wp-config.php file and execute tests against the real database., _(*1)

See - https://github.com/emeraldjava/wordpress-tests-core - https://packagist.org/packages/emeraldjava/wordpress-tests-core, _(*2)

Usage

Example project's composer.json, _(*3)

{
    "require": {
        "johnpbloch/wordpress": "*"
    },
    "require-dev": {
        "emeraldjava/wordpress-tests-core": "dev-master",
        "phpunit/phpunit": "*"
    },
    "extra": {
        "wordpress-install-dir": "./../../",
        "wordpress-tests-core-dir": "./tests"
    }
}

Astrisk versions used for timelessness... You should use a version constraint appropriate for your needs., _(*4)

Example project file structure

├── composer.json
├── phpunit.xml
└──  tests
   ├── wp-tests-config.php [REQUIRED]
   └── core
       ├── bootstrap.php
       ├── ...

tests/core could be any directory, but it must be defined under the extra key as shown above., _(*5)

wp-tests-config.php

This file is the equivalent of wp-config.php when running your PHPUnit tests. Due to the limitations imposed by the WordPress core bootstrap.php file, this file must be located as a sibling of the directory specified at wordpress-tests-core-dir as shown above., _(*6)

Then you may simply bootstrap PHPUnit with the WordPress core bootstrap file directly., _(*7)

Example phpunit.xml excerpt

<phpunit
    bootstrap="tests/core/bootstrap.php"
    ...

Other considerations

This package is not a complete replacement for the more commonly known install-wp-tests.sh script. It is just a library., _(*8)