yukihiko-shinoda / docker-compose-phpunit-wordpress-plugin

Docker Compose for PHPUnit for WordPress plugin.

💻PHPUnit Environment for WordPress Plugin🌐

Supplies PHPUnit environment built acording to official document on WordPress.org.

Contents:

• Benefit
• Requirement
• Quickstart
• Out of scope

Benefit

• 🛠️Use for backend development
• 🎈Easy to prepare
• ✨Clean for PC

🛠️Use for backend development

This environment provides following tools:

• PHPUnit
• Mockery
• PHP_CodeSniffer

And also can work with Visual Studio Code. You can lint your code on editor in real time.

🎈Easy to prepare

You can skip much steps to prepare environment. And you will be able to start Unit Test for WordPres plugin with only few steps.

✨Clean for PC

You don't need to install any SDKs in your PC without only few requirements. You will be free from regular maintenance for development environment.

Requirement

• Docker
• Docker Compose

Optional

• Visual Studio Code (Recommend)
  • In case when Windows, only Windows 10 Pro/Enterprise is supported.

Quickstart

With Visual Studio Code (Recommend)

Tutorial with screenshot are available on the Wiki.

Without Visual Studio Code

If you want to use other editor or IDE, you also can use this environment only for running PHPUnit or PHP_CodeSniffer.

1. Clone or download

git clone https://github.com/yukihiko-shinoda/docker-compose-phpunit-wordpress-plugin.git

2. Set environment variables

Copy .env.dist to .env.

copy .env.dist .env

Edit .env to set PATH_TO_INDIVIDUAL_PLUGIN_DIRECTORY.

Ex:

PATH_TO_INDIVIDUAL_PLUGIN_DIRECTORY=../plugins/staticpress2019
# DOCKER_IMAGE_PHPUNIT=futureys/phpunit-wordpress-plugin:4.3.22-php7.1.33-apache-buster
# MYSQL_VERSION=5.6

3. Execute Docker Compose run

docker-compose run phpunit

And then, you can execute PHPUnit and PHP_CodeSniffer.

phpunit

phpcs

Out of scope

UI test is not available by this environment.

docker-compose-phpunit-wordpress-plugin's Issues

Error: The container name "/database" is already in use by container

This is a very useful image. Thank you.

Sometimes when I start it, I get an error like this ERROR: for database Cannot create container for service database: Conflict. The container name "/database" is already in use by container "88314d275e3321b1e97b0de1a657da5f18f9722b5261f850d397d912b456ced3". You have to remove (or rename) that contai ner to be able to reuse that name.

I am then able to remove that container -- docker rm 88314d275e3321b1e97b0de1a657da5f18f9722b5261f850d397d912b456ced3 -- and start over and everything is fine. So, not a huge deal, but possible bug or maybe I'm wrong.

My docker-compose

version: '3.7'
services:
  database:
    container_name: database
    environment:
      MYSQL_ROOT_PASSWORD: examplepass
    image: mysql:5.7

  phpunit:
    command:
      - bash
    container_name: phpunit
    depends_on:
      - database
    environment:
      DATABASE_PASSWORD: examplepass
    image: futureys/phpunit-wordpress-plugin
    stdin_open: true
    tty: true
    volumes:
      - .:/plugin