bahrul-rasyid / wp-dev-docker

WordPress Starter with Docker.

1. copy .env-sample to .env
2. edit environment values
3. run docker-compose up -d or docker-compose up -d --build

phpunit - plugin

1. generate files docker compose exec -it wordpress wp --allow-root scaffold plugin-tests my-plugin
2. Install composer packages docker compose exec -it wordpress composer install
3. create test database: wp_tests
4. run phpunit: docker compose exec -it wordpress ../vendor/bin/phpunit --configuration wp-content/plugins/my-plugin

wp-dev-docker's Issues

create wp_tests db on initialization

integrate phpunit test

• dockerfile - install phpunit, subversion and default-mysql-client

# Install PHPUnit
RUN curl https://phar.phpunit.de/phpunit-9.phar -L -o phpunit.phar
RUN chmod +x phpunit.phar
RUN mv phpunit.phar /usr/local/bin/phpunit

# update package list
RUN apt-get update

# install subversion and mysql client
RUN apt-get install -y subversion default-mysql-client

• svn exports
  svn export --quiet --ignore-externals https://develop.svn.wordpress.org/tags/[VERSION]/tests/phpunit/includes/ ./wordpress-tests-lib/includes
svn export --quiet --ignore-externals https://develop.svn.wordpress.org/tags/[VERSION]/tests/phpunit/data/ ./wordpress-tests-lib/data

• wp-tests-config.php

wp-tests-config.php

<?php

/* Path to the WordPress codebase you'd like to test. Add a forward slash in the end. */
define( 'ABSPATH', '/var/www/html/' );

/*
 * Path to the theme to test with.
 *
 * The 'default' theme is symlinked from test/phpunit/data/themedir1/default into
 * the themes directory of the WordPress installation defined above.
 */
define( 'WP_DEFAULT_THEME', 'default' );

/*
 * Test with multisite enabled.
 * Alternatively, use the tests/phpunit/multisite.xml configuration file.
 */
// define( 'WP_TESTS_MULTISITE', true );

/*
 * Force known bugs to be run.
 * Tests with an associated Trac ticket that is still open are normally skipped.
 */
// define( 'WP_TESTS_FORCE_KNOWN_BUGS', true );

// Test with WordPress debug mode (default).
define( 'WP_DEBUG', true );

// ** Database settings ** //

/*
 * This configuration file will be used by the copy of WordPress being tested.
 * wordpress/wp-config.php will be ignored.
 *
 * WARNING WARNING WARNING!
 * These tests will DROP ALL TABLES in the database with the prefix named below.
 * DO NOT use a production database or one that is shared with something else.
 */

define( 'DB_NAME', 'wp-test' );
define( 'DB_USER', 'root' );
define( 'DB_PASSWORD', 'root' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8' );
define( 'DB_COLLATE', '' );

/**#@+
 * Authentication Unique Keys and Salts.
 *
 * Change these to different unique phrases!
 * You can generate these using the {@link https://api.wordpress.org/secret-key/1.1/salt/ WordPress.org secret-key service}
 */
define( 'AUTH_KEY',         'put your unique phrase here' );
define( 'SECURE_AUTH_KEY',  'put your unique phrase here' );
define( 'LOGGED_IN_KEY',    'put your unique phrase here' );
define( 'NONCE_KEY',        'put your unique phrase here' );
define( 'AUTH_SALT',        'put your unique phrase here' );
define( 'SECURE_AUTH_SALT', 'put your unique phrase here' );
define( 'LOGGED_IN_SALT',   'put your unique phrase here' );
define( 'NONCE_SALT',       'put your unique phrase here' );

$table_prefix = 'wptests_';   // Only numbers, letters, and underscores please!

define( 'WP_TESTS_DOMAIN', 'example.org' );
define( 'WP_TESTS_EMAIL', '[email protected]' );
define( 'WP_TESTS_TITLE', 'Test Blog' );

define( 'WP_TESTS_PHPUNIT_POLYFILLS_PATH', '/var/www/html/PHPUnit-Polyfills');

define( 'WP_PHP_BINARY', 'php' );

define( 'WPLANG', '' );

• PHPUnit-Polyfills - https://github.com/Yoast/PHPUnit-Polyfills

• Generate the plugin test files