Docker-LAMP

Docker-LAMP is a set of docker images that include the ubuntu:22.04 baseimage, along with a LAMP stack (Apache, MySQL and multiple PHP) all in one handy package.

With Ubuntu 22.04 images on the latest tags, Docker-LAMP is flexible enough to use with all of your LAMP projects.

Introduction
Image Versions
Using the image
Adding your own content
Developing the image
- Building and running
Inspiration
Contributing
License

Introduction

As a developer, part of my day to day role is to build LAMP applications. I searched in vein for an image that had everything I wanted, up-to-date packages, a simple interface, good documentation and active support.

Designed to be a single interface that just 'gets out of your way', and works on 22.04 with php 5, 7, and 8.

Image Versions

The table below shows the PHP, MySQL and Apache versions that come with it.

Component	`latest`
Apache	`2.4.29`
MySQL	`5.7.34`
PHP	`5.6`, `7.4`, `8.2`
phpMyAdmin	`5.2.1`

Using the image

On the command line

This is the quickest way

# Launch a 22.04 based image
docker run -p "80:80" -v ${PWD}/app:/app appel/docker-lamp:latest

With a Dockerfile

FROM appel/docker-lamp:latest

# Your custom commands

CMD ["/run.sh"]

MySQL Databases

By default, the image comes with a root MySQL account that has no password. This account is only available locally, i.e. within your application. It is not available from outside your docker image or through phpMyAdmin.

When you first run the image you'll see a message showing your admin user's password. This user can be used locally and externally, either by connecting to your MySQL port (default 3306) and using a tool like MySQL Workbench or Sequel Pro, or through phpMyAdmin.

If you need this login later, you can run docker logs CONTAINER_ID and you should see it at the top of the log.

Creating a database

So your application needs a database - you have two options...

PHPMyAdmin
Command line

PHPMyAdmin

Docker-LAMP comes pre-installed with phpMyAdmin available from http://DOCKER_ADDRESS/phpmyadmin.

NOTE: you cannot use the root user with PHPMyAdmin. We recommend logging in with the admin user mentioned in the introduction to this section.

Command Line

First, get the ID of your running container with docker ps, then run the below command replacing CONTAINER_ID and DATABASE_NAME with your required values:

docker exec CONTAINER_ID  mysql -uroot -e "create database DATABASE_NAME"

Change PHP Version

You can change PHP version using .htaccess on each project folder.

# change to PHP 5.6
<FilesMatch \.php>
    # Apache 2.4.10+ can proxy to unix socket
    SetHandler "proxy:unix:/var/run/php/php5.6-fpm.sock|fcgi://localhost/"
</FilesMatch>

# change to PHP 7.4
<FilesMatch \.php>
    # Apache 2.4.10+ can proxy to unix socket
    SetHandler "proxy:unix:/var/run/php/php7.4-fpm.sock|fcgi://localhost/"
</FilesMatch>

# change to PHP 8.2
<FilesMatch \.php>
    # Apache 2.4.10+ can proxy to unix socket
    SetHandler "proxy:unix:/var/run/php/php8.2-fpm.sock|fcgi://localhost/"
</FilesMatch>

Adding your own content

The 'easiest' way to add your own content to the lamp image is using Docker volumes. This will effectively 'sync' a particular folder on your machine with that on the docker container.

The below examples assume the following project layout and that you are running the commands from the 'project root'.

/ (project root)
/app/ (your PHP files live here)
/mysql/ (docker will create this and store your MySQL data here)

In english, your project should contain a folder called app containing all of your app's code. That's pretty much it.

Adding your app

The below command will run the docker image appel/docker-lamp:latest interactively, exposing port 80 on the host machine with port 80 on the docker container. It will then create a volume linking the app/ directory within your project to the /app directory on the container. This is where Apache is expecting your PHP to live.

docker run -i -t -p "80:80" -v ${PWD}/app:/app appel/docker-lamp:latest

Persisting your MySQL

The below command will run the docker image appel/docker-lamp:latest, creating a mysql/ folder within your project. This folder will be linked to /var/lib/mysql where all of the MySQL files from container lives. You will now be able to stop/start the container and keep your database changes.

You may also add -p 3306:3306 after -p 80:80 to expose the mysql sockets on your host machine. This will allow you to connect an external application such as SequelPro or MySQL Workbench.

docker run -i -t -p "80:80" -v ${PWD}/mysql:/var/lib/mysql appel/docker-lamp:latest

Doing both

The below command is our 'recommended' solution. It both adds your own PHP and persists database files. We have created a more advanced alias in our .bash_profile files to enable the short commands ldi and launchdocker. See the next section for an example.

docker run -i -t -p "80:80" -v ${PWD}/app:/app -v ${PWD}/mysql:/var/lib/mysql appel/docker-lamp:latest

`.bash_profile` alias examples

The below example can be added to your ~/.bash_profile file to add the alias commands ldi and launchdocker. By default it will launch the 22.04 image.

# A helper function to launch docker container using appel/docker-lamp with overrideable parameters
#
# $1 - Apache Port (optional)
# $2 - MySQL Port (optional - no value will cause MySQL not to be mapped)
function launchdockerwithparams {
    APACHE_PORT=80
    MYSQL_PORT_COMMAND=""

    if ! [[ -z "$1" ]]; then
        APACHE_PORT=$1
    fi

    if ! [[ -z "$2" ]]; then
        MYSQL_PORT_COMMAND="-p \"$2:3306\""
    fi

    docker run -i -t -p "$APACHE_PORT:80" $MYSQL_PORT_COMMAND -v ${PWD}/app:/app -v ${PWD}/mysql:/var/lib/mysql appel/docker-lamp:latest
}
alias launchdocker='launchdockerwithparams $1 $2'
alias ldi='launchdockerwithparams $1 $2'

Example usage

# Launch docker and map port 80 for apache
ldi

# Launch docker and map port 8080 for apache
ldi 8080

# Launch docker and map port 3000 for apache along with 3306 for MySQL
ldi 3000 3306

Developing the image

Building and running

# Clone the project from Github
git clone https://github.com/gagalkoding/docker-lamp.git
cd docker-lamp

# Build the images
docker build -t=appel/docker-lamp:latest -f ./2204/Dockerfile .

# Run the image as a container
docker run -d -p "3000:80" appel/docker-lamp:latest

# Sleep to allow the container to boot
sleep 5

# Curl out the contents of our new container
curl "http://$(docker-machine ip):3000/"

Inspiration

This image was originally based on mattrayner/lamp, with a few changes to make it compatible with the Laravel, CodeIgniter, WHMCS (with ionCube 10.2), and other CMS/Framework.

I also changed the setup to create ubuntu using arm64v8 so that this project can run very well on Apple Silicon (especially on MAC M1).

Contributing

If you wish to submit a bug fix or feature, you can create a pull request and it will be merged pending a code review.

Clone/fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')\
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

License

Docker-LAMP is licensed under the Apache 2.0 License.

appel/docker-lamp