Docker LAMP stack for web development

The container is intended for local usage and should never be used in production environment.

What is inside

• Apache|Nginx
• MariaDB
• PHP 8
• phpMyAdmin
• Xdebug
• Composer
• PHP-CS-Fixer
• MailHog
• Node.js, npm, Yarn
• SSH server

Creating the container

The container can be created in two ways. The first one (classic) is exposing container services through the explicit port mapping.

#!/usr/bin/env bash

PROJECT_NAME=example
PROJECT_DIR=/var/docker/projects/$PROJECT_NAME

docker create \
 -h $PROJECT_NAME \
 -p 80:80 \
 -v $PROJECT_DIR/www:/var/www \
 -v $PROJECT_DIR/mysql:/var/lib/mysql \
 --name $PROJECT_NAME \
 --env SERVER=apache \
 --group-add sudo \
 --group-add www-data \
 attr/lamp

At this point the container can be started with the following command docker start example. Having this done you can access web server index page by navigating to the following url: http://localhost.

If you want to use Nginx instead of Appache set SERVER=nginx in the above command.

The second way requires you to create custom docker network.

#!/usr/bin/env bash

docker network create \
  --subnet=172.28.0.0/16 \
  --gateway=172.28.0.254 \
  my-net

Now the container can be created as follows:

#!/usr/bin/env bash

PROJECT_NAME=example
PROJECT_DIR=/var/docker/projects/$PROJECT_NAME

docker create \
 -h $PROJECT_NAME \
 -v $PROJECT_DIR/www:/var/www \
 -v $PROJECT_DIR/mysql:/var/lib/mysql \
 --net my-net \
 --ip 172.28.0.1 \
 --name $PROJECT_NAME \
 --env SERVER=apache \
 --group-add sudo \
 --group-add www-data \
  attr/lamp

The IP address may be whatever you like but make sure it belongs the subnet you created before. It can be helpful to map the IP address to a hostname using /etc/hosts file.

172.28.0.1 example.local

New containers can be attached to the same network or to a distinct one for better isolation.

Connecting to the container

It is recommended you connect to the container using lamp account.

docker exec -itu lamp:www-data example bash

You may create an alias for less typing.

echo 'alias example="docker start example && docker exec -itu lamp example bash"' >> ~/.bashrc

Xdebug

Xdebug is disabled by default for performance reason. Run the following command to enable on before debugging.

sudo xdebug on

Available ports

• 22 - SSH
• 80 - HTTP
• 443 - HTTPS
• 1025 - MailHog SMTP
• 3306 - MySQL
• 8025 - MailHog web UI
• 8088 - PhpMyAdmin

Access

• Host user name - lamp
• Host user password - 123
• MySQL root password - 123