Docker Image for WP Browser Codeception Testing

This is a standalone docker container for running Codeception tests on a WordPress site.

Note that this is designed to run in the WordPress root folder, not inside a plugin or theme folder. This is best used for running tests on a custom site.

Usage

Configure WP Browser to run tests on your site.

Create a docker-compose.yml in your project root based on the one below.

Run the default command on the wpbrowser container

docker-compose --file docker-compose.yml run --rm wpbrowser

Sample docker-compose

version: '3.7'

services:

  db:
    image: mysql:5.7
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE:      wordpress
      MYSQL_USER:          wordpress
      MYSQL_PASSWORD:      wordpress

  wpbrowser:
    image: ryanshoover/wp-browser:latest
    links:
      - db:mysql
    volumes:
      - wp-content:/var/www/html/wp-content
      - tests:/var/www/html/tests
      - codeception.yml:/var/www/html/codeception.yml
    command: codecept run
    environment:
      DB_NAME:     wordpress
      DB_HOST:     'db:3306'
      DB_USER:     wordpress
      DB_PASSWORD: wordpress

Opinionated Configuration

This repo has an opinion on how Codeception should be set up. Specifically, it includes a codeception.dist.yml file that is based on WP Browser defaults. You can override these settings by placing a codeception.yml file in your project root folder.

The container that is created will have a working instance of WordPress inside it. The instance has a URL of http://localhost and expects a database prefix of wp_.