emeraldjava/wordpress-tests-core

WordPress core PHPUnit test library

v1.0 2017-07-27 12:37 UTC

Requires

• aaemnnosttv/wordpress-tests-core-installer: ~0.1
• composer/installers: ^1.0

GPL-2.0+

• Evan Mattson
• WordPress Community

README

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.

See

• https://github.com/emeraldjava/wordpress-tests-core
• https://packagist.org/packages/emeraldjava/wordpress-tests-core

Usage

Example project's composer.json

{
    "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.

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.

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.

Then you may simply bootstrap PHPUnit with the WordPress core bootstrap file directly.

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.