Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/keopx/docker-lamp
Debian 9, Apache 2.4, MySQL 8.0/5.7/5.6/5.5/ and PHP 7.3/7.2/7.1/7.0/5.6 for Docker. Additional tools: phpMyAdmin and MailHog
https://github.com/keopx/docker-lamp
docker docker4drupal dockerfile drupal drupal-7 drupal-8 mailhog mysql mysql-database mysql8 php php56 php7 php71 php72 phpmyadmin redis varnish varnish-vcl vcl
Last synced: about 1 month ago
JSON representation
Debian 9, Apache 2.4, MySQL 8.0/5.7/5.6/5.5/ and PHP 7.3/7.2/7.1/7.0/5.6 for Docker. Additional tools: phpMyAdmin and MailHog
- Host: GitHub
- URL: https://github.com/keopx/docker-lamp
- Owner: keopx
- License: gpl-3.0
- Created: 2016-08-19T17:08:45.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-11-16T16:33:15.000Z (almost 6 years ago)
- Last Synced: 2024-04-09T14:24:24.272Z (5 months ago)
- Topics: docker, docker4drupal, dockerfile, drupal, drupal-7, drupal-8, mailhog, mysql, mysql-database, mysql8, php, php56, php7, php71, php72, phpmyadmin, redis, varnish, varnish-vcl, vcl
- Language: VCL
- Homepage: https://www.keopx.net
- Size: 155 KB
- Stars: 56
- Watchers: 13
- Forks: 21
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Native docker-based local environment for Drupal
Use this Docker compose file to spin up local environment for [Drupal](https://wwww.drupal.org) 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](https://www.keopx.net) Docker **[Drupal](https://wwww.drupal.org)** optimized images for apache-php with varnish and MySQL.
---
* [Overview](#overview)
* [Instructions](#instructions)
* [Usage](#usage)
* [Containers](#containers)
* [Custom settings](#custom-settings)
* [Varnish](#varnish-1)
* [drupal-base.vcl for Drupal](#drupal-basevcl-for-drupal)
* [Environment](#environment)
* [Apache PHP](#apache-php-1)
* [Web Data Volume](#web-data-volume)
* [Apache Virtualhost](#apache-virtualhost)
* [PHP](#php)
* [Xdebug](#xdebug)
* [Drush](#drush)
* [SSH](#ssh)
* [Environment](#environment-1)
* [MySQL](#mysql-1)
* [MySQL Data Volume](#mysql-data-volume)
* [Custom my.cnf](#custom-mycnf)
* [Environment](#environment-2)
* [Redis](#redis-1)
* [phpMyAdmin](#phpmyadmin-1)
* [Environment](#environment-3)
* [Mailhog](#mailhog-1)
## Overview
The [Drupal](https://wwww.drupal.org) bundle consist of the following containers:
| Container | Version | Service name | Image | Public Port | Enabled by default |
| --------- | ------- | ------------ | ----- | ----------- | ------------------ |
| [Varnish](#varnish) | [5.2](https://github.com/keopx/docker-varnish/blob/master/5.2/)/[5.1](https://github.com/keopx/docker-varnish/blob/master/5.1/)/[5.0](https://github.com/keopx/docker-varnish/blob/master/5.0/)/[4.0](https://github.com/keopx/docker-varnish/blob/master/4.0/) | varnish | keopx/varnish | 80 | ✓ |
| [Apache PHP](#apache-php) | [7.3](https://github.com/keopx/docker-apache-php/blob/master/7.3/)/[7.2](https://github.com/keopx/docker-apache-php/blob/master/7.2/)/[7.1](https://github.com/keopx/docker-apache-php/blob/master/7.1/)/[7.0](https://github.com/keopx/docker-apache-php/blob/master/7.0/)/[5.6](https://github.com/keopx/docker-apache-php/blob/master/5.6/) | apache-php | keopx/apache-php | 8008 | ✓ |
| [MySQL](#mysql) | [8.0](https://github.com/keopx/docker-mysql/blob/master/8.0/)/[5.7](https://github.com/keopx/docker-mysql/blob/master/5.7/)/[5.6](https://github.com/keopx/docker-mysql/blob/master/5.6/)/[5.5](https://github.com/keopx/docker-mysql/blob/master/5.5/) | mysql | keopx/mysql | 3306 | ✓ |
| [Redis](#redis) | [4.0](https://github.com/keopx/docker-redis/blob/master/4.0/)/[3.2](https://github.com/keopx/docker-redis/blob/master/3.2/)/[3.0](https://github.com/keopx/docker-redis/blob/master/3.0/) | redis | keopx/redis | 6379 | ✓ |
| [phpMyAdmin](#phpmyadmin) | | phpmyadmin | phpmyadmin/phpmyadmin | 8080 | ✓ |
| [Mailhog](#mailhog) | | mailhog | mailhog/mailhog | 8025 - 1025 | ✓ |
## 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:
```bash
$ cp example.env .env
$ docker-compose up -d
```
Stop:
```bash
$ docker-compose stop
```
Or down (warning: this command remove volume changes):
```bash
$ docker-compose down
```
#### Run bash
```bash
docker exec -it dockerlamp_web_1 /bin/bash
```
Replace _dockerlamp_web_1_ with _name_ of:
```bash
docker-compose ps
```
#### Access to containers
Current user is `keopx` with uid `1000`:
```bash
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](https://github.com/keopx/docker-varnish/blob/master/5.2/Dockerfile))
- 5.1 ([5.1/Dockerfile](https://github.com/keopx/docker-varnish/blob/master/5.1/Dockerfile))
- 5.0 ([5.0/Dockerfile](https://github.com/keopx/docker-varnish/blob/master/5.0/Dockerfile))
- 4.0 ([4.0/Dockerfile](https://github.com/keopx/docker-varnish/blob/master/4.0/Dockerfile))
### Apache PHP
- 7.2, latest ([7.2/Dockerfile](https://github.com/keopx/docker-apache-php/blob/master/7.2/Dockerfile))
- 7.1 ([7.1/Dockerfile](https://github.com/keopx/docker-apache-php/blob/master/7.1/Dockerfile))
- 7.0 ([7.0/Dockerfile](https://github.com/keopx/docker-apache-php/blob/master/7.0/Dockerfile))
- 5.6 ([5.6/Dockerfile](https://github.com/keopx/docker-apache-php/blob/master/5.6/Dockerfile))
### MySQL
- 8.0, latest ([8.0/Dockerfile](https://github.com/keopx/docker-mysql/blob/master/8.0/Dockerfile))
- 5.7 ([5.7/Dockerfile](https://github.com/keopx/docker-mysql/blob/master/5.7/Dockerfile))
- 5.6 ([5.6/Dockerfile](https://github.com/keopx/docker-mysql/blob/master/5.6/Dockerfile))
- 5.5 ([5.5/Dockerfile](https://github.com/keopx/docker-mysql/blob/master/5.6/Dockerfile))
### Redis
- 4.0, latest ([4.0/Dockerfile](https://github.com/keopx/docker-redis/blob/master/4.0/Dockerfile))
- 3.2 ([3.2/Dockerfile](https://github.com/keopx/docker-redis/blob/master/3.2/Dockerfile))
- 3.0 ([3.0/Dockerfile](https://github.com/keopx/docker-redis/blob/master/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](https://www.drupal.org) in [drupal-base.vcl](https://github.com/keopx/docker-lamp/blob/master/config/varnish/4.0/drupal-base.vcl)
#### drupal-base.vcl for Drupal
You can check a special varnish vcl file for [Drupal](https://wwww.drupal.org) **drupal-base.vcl** based in [NITEMAN](https://github.com/NITEMAN) config file: [drupal-base.vcl](https://github.com/NITEMAN/varnish-bites/blob/master/varnish4/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.
```yaml
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.
```yaml
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.
```dotenv
# 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
```yaml
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.
```yaml
volumes:
- ./config/vhosts:/etc/apache2/sites-enabled
```
**Note:** this example is for _www.drupal8.localhost_ site. All domains `*.localhost` are resolved as `localhost`
```bash
#!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:
```bash
$ 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](https://github.com/keopx/docker-lamp/blob/master/config/php/php.ini-development) and [production](https://github.com/keopx/docker-lamp/blob/master/config/php/php.ini-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](https://wwww.drupal.org).
Also we create `ssmtp`, `drush` and `ssh` variables for send email, using drush aliases into container and connect to remote machines from container.
```yaml
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:
```bash
$ 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](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.
```yaml
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.
```yaml
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*.
```yaml
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.
```yaml
volumes:
# ssmtp mail sender.
- PHP_SENDMAIL_PATH="${PHP_SENDMAIL_PATH}"
```
##### Set `.env` file.
```dotenv
## 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
```yaml
volumes:
- ${MYSQL_DATA_DIR}:/var/lib/mysql
```
#### Custom my.cnf
You can check [my.cnf](https://github.com/keopx/docker-lamp/blob/master/config/mysql/my.cnf) and change you need variables.
```yaml
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.
```yaml
environment:
- MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}
- MYSQL_DATABASE=${MYSQL_DATABASE}
- MYSQL_USER=${MYSQL_USER}
- MYSQL_PASSWORD=${MYSQL_PASSWORD}
```
##### Set `.env` file.
```dotenv
## 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.
```yaml
ports:
- "${REDIS_PORT}:6379"
```
##### Set `.env` file.
```dotenv
## 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.
```yaml
ports:
- "${PMA_PORT}:80"
environment:
- PMA_HOST=${PMA_HOST}
```
##### Set `.env` file.
* PMA_HOST: Host to connect phpMyAdmin.
```yaml
## 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.
```yaml
ports:
- "${MAILHOG_PORT_SMTP}:1025"
- "${MAILHOG_PORT_WEB}:8025"
```
##### Set `.env` file.
```dotenv
## Mailhog
# Puerto de la interfaz web de mailhog
MAILHOG_PORT_SMTP=1025
MAILHOG_PORT_WEB=8025
```