Native docker-based local environment for Drupal

Use this Docker compose file to spin up local environment for Drupal with a native Docker app

This docker setup works with Debian 9, Varnish 5.2/5.1/5.0/4.0, Apache 2.4, PHP 7.2/7.1/7.0/5.6, MySQL 8.0/5.7/5.6/5.5/ and Redis 4.0/3.2/3.0. This setup have Mailhog and phpMyAdmin as helper tools.

This is keopx Docker Drupal optimized images for apache-php with varnish and MySQL.

• Overview
• Instructions
  • Usage
• Containers
• Custom settings
  • Varnish
    • drupal-base.vcl for Drupal
    • Environment
  • Apache PHP
    • Web Data Volume
    • Apache Virtualhost
    • PHP
    • Xdebug
    • Drush
    • SSH
    • Environment
  • MySQL
    • MySQL Data Volume
    • Custom my.cnf
    • Environment
  • Redis
  • phpMyAdmin
    • Environment
  • Mailhog

Overview

The Drupal bundle consist of the following containers:

Instructions

Feel free to adjust volumes and ports in the compose file for your convenience.

Environment

New version works with environment variables.

You can use example.env as .env (Only launch: cp example.env .env)

Here list of variables:

• Varnish version
  • VARNISH_VERSION=4.0
  • VARNISH_PORT=80
  • VARNISH_BACKEND_PORT=80
  • VARNISH_BACKEND_IP=web
  • VARNISH_MEMORY=500M
  • VARNISH_ADMIN_PORT=6082
• APACHE with PHP - Versión de PHP {7.2|7.1|7.0|5.6}
  • WEB_PORT=8008
  • WEB_PORT_SSL=8433
  • WEB_DATA_DIR=./data/www
  • PHP_VERSION=7.1
  • PHP_SENDMAIL_PATH=/usr/sbin/ssmtp -t
  • PHP_SENDMAIL_DOMAIN=mail:1025
  • SSMTP=./config/ssmtp/ssmtp.conf
  • DRUSH=~/.drush
• MySQL - Versión de MySQL {8.0|5.7|5.6|5.5}
  • MYSQL_VERSION=5.7
  • MYSQL_PORT=3306
  • MYSQL_ROOT_PASSWORD=root
  • MYSQL_DATABASE=db
  • MYSQL_USER=db
  • MYSQL_PASSWORD=db
  • MYSQL_DATA_DIR=./data/database
• Redis - Versión de Redis {4.0|3.2|3.0}
  • REDIS_VERSION=4.0
  • REDIS_PORT=6379
• PhpMyadmin
  • PMA_PORT=8080
  • PMA_HOST=mysql
• Mailhog
  • MAILHOG_PORT_SMTP=1025
  • MAILHOG_PORT_WEB=8025

Usage

Run:

$ cp example.env .env
$ docker-compose up -d

Stop:

$ docker-compose stop

Or down (warning: this command remove volume changes):

$ docker-compose down

Run bash

docker exec -it dockerlamp_web_1 /bin/bash

Replace dockerlamp_web_1 with name of:

docker-compose ps

Access to containers

Current user is keopx with uid 1000:

docker-compose exec -it --user=keopx web bash
docker-compose exec -it --user=keopx web drush 
docker-compose exec -it --user=keopx web composer

Containers

Varnish

Available tags are:

• 5.2, latest (5.2/Dockerfile)
• 5.1 (5.1/Dockerfile)
• 5.0 (5.0/Dockerfile)
• 4.0 (4.0/Dockerfile)

Apache PHP

• 7.2, latest (7.2/Dockerfile)
• 7.1 (7.1/Dockerfile)
• 7.0 (7.0/Dockerfile)
• 5.6 (5.6/Dockerfile)

MySQL

• 8.0, latest (8.0/Dockerfile)
• 5.7 (5.7/Dockerfile)
• 5.6 (5.6/Dockerfile)
• 5.5 (5.5/Dockerfile)

Redis

• 4.0, latest (4.0/Dockerfile)
• 3.2 (3.2/Dockerfile)
• 3.0 (3.0/Dockerfile)

phpMyAdmin

This is a default image. Only use to have a easy access to database information.

MailHog

This is a default image. Use to have easy mailsender and mail watcher to test email without send to real account.

Custom settings

Varnish

By default we can use a standard default.vcl.

In addition, you can check a varnish vcl for Drupal in drupal-base.vcl

drupal-base.vcl for Drupal

You can check a special varnish vcl file for Drupal drupal-base.vcl based in NITEMAN config file: drupal-base.vcl

Note: drupal-base.vcl uses MIT license.

If you like to add drupal-base.vcl add this lines. Added by default to 4.0 version.

    volumes:
      - ./config/varnish/${VARNISH_VERSION}/drupal-base.vcl:/etc/varnish/default.vcl

Note: check different version into config/varnish directory.

Environment

The first two lines works to setup a default varnish port and memory usage limit.

The second two lines only works to change default.vcl setup to run correctly.

web is name of linked apache-php image name.

    environment:
      - VARNISH_PORT=${VARNISH_BACKEND_PORT}
      - VARNISH_MEMORY=${VARNISH_MEMORY}
      # Next values only works with default default.vcl file.
      - VARNISH_BACKEND_IP=${VARNISH_BACKEND_IP}
      - VARNISH_BACKEND_PORT=${VARNISH_BACKEND_PORT}

Set .env file.

# Varnish version
VARNISH_VERSION=4.0
VARNISH_PORT=80
VARNISH_BACKEND_PORT=80
VARNISH_BACKEND_IP=web
VARNISH_MEMORY=500M
VARNISH_ADMIN_PORT=6082

Apache PHP

Web Data Volume

    volumes:
      - ${WEB_DATA_DIR}:/var/www # Data.

Apache Virtualhost

By default you can use http://localhost as working place. But if you would like a custom host to work add this changes.

You can see volumes to check existing configurations for vhosts. vhosts volume mount by default to help with setup.

    volumes:
      - ./config/vhosts:/etc/apache2/sites-enabled

Note: this example is for www.drupal8.localhost site. All domains *.localhost are resolved as localhost

#!bash

cp config/vhosts/example.conf.example config/vhosts/drupal8.conf
sed -i 's/example/drupal8/' config/vhosts/drupal8.conf

NOTE: review your project path.

And reload system:

$ docker-compose stop
$ docker-compose up -d

PHP

Use some setup by default. You can (un)comment to change behaviour.

You can see two php.ini templates with different setup, development and production setup.

In addition, you can check apcu, opcache, xdebug and xhprof configuration, the same file for php 7.3 (beta), 7.2, 7.1, 7.0 and 5.6, and opcache recomended file version for Drupal.

Also we create ssmtp, drush and ssh variables for send email, using drush aliases into container and connect to remote machines from container.

    volumes:
      - ${WEB_DATA_DIR}:/var/www # Data.
      - ./config/vhosts:/etc/apache2/sites-enabled
      ### See: https://github.com/keopx/docker-lamp for more information.
      ## php.ini for php 7.x and remove environment varibles.
      - ./config/php/${PHP_VERSION}/php.ini:/etc/php/${PHP_VERSION}/apache2/php.ini
      ## Opcache
      # - ./config/php/opcache-recommended.ini:/etc/php/${PHP_VERSION}/apache2/conf.d/10-opcache.ini
      ## APCU
      # - ./config/php/apcu.ini:/etc/php/${PHP_VERSION}/apache2/conf.d/20-apcu.ini
      ## Xdebug
      # - ./config/php/xdebug.ini:/etc/php/${PHP_VERSION}/apache2/conf.d/20-xdebug.ini
      ## Xhprof
      #- ./config/php/xhprof.ini:/etc/php/${PHP_VERSION}/apache2/conf.d/20-xhprof.ini
      ## SSMTP support
      #- ${SSMTP}:/etc/ssmtp/ssmtp.conf
      ## Drush aliases support. e.g.
      # - ${WEB_DRUSH}:/root/.drush
      ## SSH support. Uncomment environment -> # - SSH_AUTH_SOCK=/ssh-agent
      # - ${SSH_AUTH_SOCK}:/ssh-agent

NOTE: if you like enabled APCu in PHP 7.0, you need enabled apc.ini.

e.g.: if you need add more PHP memory_limit modify ./config/php-{version}/php.ini file and reload system to works:

$ docker-compose stop
$ docker-compose up -d

Xdebug

Xdebug is enabled to debug shell command as drush.

Can read this post https://www.keopx.net/blog/debugging-drush-scripts-con-xdebug-y-phpstorm

Note: remember check docker-compose.yml to enable this feature.

Drush

If you need run some drush command to sync with some alias, to access to remote sync database or files you can uncomment next line to works into docker image.

    volumes:
      # Drush aliases support. e.g.
      - ${WEB_DRUSH}:/root/.drush

SSH

If you need run some command, like a composer, to access to remote using ssh keys, you can uncomment next line to works into docker image.

    volumes:
      # SSH support. Uncomment environment -> # - SSH_AUTH_SOCK=/ssh-agent
      - ${SSH_AUTH_SOCK}:/ssh-agent

Environment

WARNING: Use only if you not use custom php.ini.

You can check in docker-composer.yml two special environment variable to setup SMTP service to test local emails.

The apache-php has ssmtp sender package. Here default setup to run by default with mailhog.

Use to connect to MailHog mail instead localhost.

    environment:
      ## WARNING: Use only if you not use custom php.ini.
      # SMTP server configruation: "domain:port" | "mail" server domain is mailhog name.
      - PHP_SENDMAIL_DOMAIN=${PHP_SENDMAIL_DOMAIN}
      # SSH support. Uncomment volumes -> # - ${SSH_AUTH_SOCK}:/ssh-agent
      - SSH_AUTH_SOCK=/ssh-agent

Other way is adding a volume.

    volumes:
      # ssmtp mail sender.
      - PHP_SENDMAIL_PATH="${PHP_SENDMAIL_PATH}"

Set .env file.

## APACHE with PHP
# Versión de PHP {7.2|7.1|7.0|5.6}
WEB_PORT=8008
WEB_PORT_SSL=8433
WEB_DATA_DIR=./data/www
PHP_VERSION=7.1
PHP_SENDMAIL_PATH=/usr/sbin/ssmtp -t
PHP_SENDMAIL_DOMAIN=mail:1025
SSMTP=./config/ssmtp/ssmtp.conf
DRUSH=~/.drush

MySQL

Use to connect to MySQl mysql instead localhost.

MySQL Data Volume

    volumes:
      - ${MYSQL_DATA_DIR}:/var/lib/mysql

Custom my.cnf

You can check my.cnf and change you need variables.

    volumes:
      ## Custom setup for MySQL
      - ./config/mysql/my.cnf:/etc/mysql/my.cnf

Environment

• MYSQL_ROOT_PASSWORD: The password for the root user. Defaults to a blank password.
• MYSQL_DATABASE: A database to automatically create. If not provided, does not create a database.
• MYSQL_USER: A user to create that has access to the database specified by MYSQL_DATABASE.
• MYSQL_PASSWORD: The password for MYSQL_USER. Defaults to a blank password.

    environment:
      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}
      - MYSQL_DATABASE=${MYSQL_DATABASE}
      - MYSQL_USER=${MYSQL_USER}
      - MYSQL_PASSWORD=${MYSQL_PASSWORD}

Set .env file.

## MySQL
# Versión de MySQL {8.0|5.7|5.6|5.5}
MYSQL_VERSION=5.7
MYSQL_PORT=3306
# Root password for MySQL
MYSQL_ROOT_PASSWORD=root
MYSQL_DATABASE=db
MYSQL_USER=db
MYSQL_PASSWORD=db
# Path donde se almacenan los datos de Mysql para conseguir persistencia entre borrados de containers
MYSQL_DATA_DIR=./data/database

Redis

Use Redis for backend cache system for Drupal.

Use to connect to Redis redis instead localhost and port 6379.

Environment

We can setup port number.

    ports:
      - "${REDIS_PORT}:6379"

Set .env file.

## Redis
# Versión de Redis {4.0|3.2|3.0}
REDIS_VERSION=4.0
REDIS_PORT=6379

phpMyAdmin

Use to connect to MySQl mysql instead localhost.

Environment

We can setup port number.

    ports:
      - "${PMA_PORT}:80"
    environment:
      - PMA_HOST=${PMA_HOST}

Set .env file.

• PMA_HOST: Host to connect phpMyAdmin.

## PhpMyadmin
# Puerto donde escucha el interfaz web de phpmyadmin
PMA_PORT=8080
PMA_HOST=mysql

MailHog

Default image and setup.

Environment

We can setup port number.

    ports:
      - "${MAILHOG_PORT_SMTP}:1025"
      - "${MAILHOG_PORT_WEB}:8025"

Set .env file.

## Mailhog
# Puerto de la interfaz web de mailhog
MAILHOG_PORT_SMTP=1025
MAILHOG_PORT_WEB=8025