nateinaction/wordpress-integration repository overview

⁠Supported tags and respective links

5.0.1-php7.3 5.0-php7.3 php7.3 (php7.3/Dockerfile⁠)

5.0.1-php7.2 5.0-php7.2 latest php7.2 (php7.2/Dockerfile⁠)

5.0.1-php7.1 5.0-php7.1 php7.1 (php7.1/Dockerfile⁠)

5.0.1-php5.6 5.0-php5.6 php5.6 (php5.6/Dockerfile⁠)

⁠WordPress Integration Docker Image

This docker image sets up a WordPress integration environment that can be used to test WordPress plugins and themes.

Testing your plugin has never been easier!

docker run --rm -v `pwd`:/workspace nateinaction/wordpress-integration ./vendor/bin/phpunit ./test-dir

Available on Docker Hub⁠

⁠What this image provides

• WordPress (located at /wordpress/src)
• WordPress Testcase, Mocks and Factories (located at /wordpress/tests/phpunit/includes/)
• xdebug

⁠What this image does NOT provide

• PHPUnit

This image is agnostic about your test runner. You can manage your own version of PHPUnit as a dev dependency in your project. Just mount your project directory and call an executable to run your tests.

⁠Bootstrap requirement

When using PHPUnit or another test runner you will need to use a bootstrap file like the following to help kick things off. With PHPUnit, you can use a bootstrap file by adding the --bootstrap FILENAME flag or by setting the bootstrap option in your phpunit.xml config file.

<?php
/**
 * Test bootstrap
 *
 * @package your-plugin
 */

$wordpress_tests = '/wordpress/tests/phpunit/includes';

/**
 * The WordPress tests functions.
 *
 * We are loading this so that we can add our tests filter
 * to load the plugin, using tests_add_filter().
 */
require_once $wordpress_tests . '/functions.php';

/**
 * Manually load the plugin main file.
 *
 * The plugin won't be activated within the test WP environment,
 * that's why we need to load it manually.
 *
 * You will also need to perform any installation necessary after
 * loading your plugin, since it won't be installed.
 */
function _manually_load_plugin() {
	require '/workspace/your-plugin-entrypoint.php';
}
tests_add_filter( 'muplugins_loaded', '_manually_load_plugin' );

/**
 * Sets up the WordPress test environment.
 *
 * We've got our action set up, so we can load this now,
 * and viola, the tests begin.
 */
require $wordpress_tests . '/bootstrap.php';

⁠Example of plugins using this image

• Segment Cache for WP Engine⁠
• WP Engine GeoTarget⁠

⁠Contributing

The goal is to keep this image a small but helpful testing companion. If you feel like it's missing something please post a PR or open a new issue!

⁠Updating WordPress

When a new version of WordPress launches, just update the WORDPRESS_VERSION in the Makefile and run make update_wp_version_all from the repository root. Then submit a PR with the changes.