Dockerised Drupal 8 development environment using PHP 7.0 on Ubuntu 16.04 with HTTP/2. This image is the development companion to the docker-drupal-php70 project.

Included Tools

Debugging Tools

• XDebug - PHP debugging and profiling.
• XHProf - function-level hierarchical profiler.

Front-end Tools

• Wraith - for visual regression testing.
• BrowserStackLocal - for automating browser tests locally (need a paid account).

PHP Documentation Tools

• DoxyGen - generate documentation from annotated PHP code. It is used to generate XML which is then interpreted by Sphinx.
• Sphinx - generate beautiful Read The Docs format using Breathe as a bridge to DoxyGen XML output.

Other

• NodeJS LTS and NVM (Node Version Manager)
• Java Runtime Environment (JRE) - project dev tools like sitespeed.io need this.

Installation

Create Presistant Database data-only container

# Build database image based off MySQL 5.7
sudo docker run -d --name mysql-drupal-php70-dev mysql:5.7 --entrypoint /bin/echo MySQL data-only container for Drupal Dev MySQL

Build Project using Docker Compose

# Customise docker-compose.yml configurations for environment.
cp docker-compose.yml.dist docker-compose.yml
vim docker-compose.yml

# Build docker containers using Docker Composer.
sudo docker-compose build --no-cache
sudo docker-compose up -d

Host Access

From the host server, add the web container IP address to the hosts file.

# Add IP address to hosts file.
./host.sh

Logging into Web Front-end

# Using the container name of the web frontend.
sudo docker exec -it dockerdrupalphp70dev_drupalphp70devweb_1 su - ubuntu

Local customisations

# Customize scripts in local folders.
cp local/bashrc.dist local/bashrc
vim local/bashrc

XDebug enable and disable

Note that XDebug CLI is disabled by default.

# Turn XDebug on / off in Apache.
xdebug on
xdebug off

# Turn XDebug on / off fopr both Apache and CLI.
xdebug on-all
xdebug off-all

BrowserStack integration

Use BrowserStack credentials to get {Access Key}

# Run BrowserStackLocal binary in background
BrowserStackLocal {Access Key} </dev/null &>/dev/null &