/docker-compose-lamp

A basic LAMP stack environment built using Docker Compose.

Primary LanguageDockerfileMIT LicenseMIT

LAMP stack built with Docker Compose

Landing Page

A basic LAMP stack environment built using Docker Compose. It consists of the following:

  • PHP
  • Apache
  • MySQL
  • phpMyAdmin
  • Redis

As of now, we have several different PHP versions. Use appropriate php version as needed:

  • 5.4.x
  • 5.6.x
  • 7.0.x
  • 7.1.x
  • 7.2.x
  • 7.3.x
  • 7.4.x

Please note that we simplified the project structure from several branches for each php version, to one centralized master branch. Please let us know if you encouter any problems.

Installation

  • Clone this repository on your local computer
  • configure .env as needed
  • Run the docker-compose up -d.
git clone https://github.com/beck24/docker-compose-lamp.git
cd docker-compose-lamp/
cp sample.env .env
// modify sample.env as needed
docker-compose up -d
// visit localhost

Your LAMP stack is now ready!! You can access it via http://localhost.

Note: the default mysql service has been removed in favor of mysql on the host system due to performance.

To connect to the host mysql use the special network value of: host.docker.internal

Should you want to use the dockerized mysql you can include the mysql yml file:

docker-compose -f docker-compose.yml -f docker-compose-mysql.yml up -d --build --remove-orphans

If you need phpmyadmin or redis they can also be included in the stack by including their files in the up command:

docker-compose -f docker-compose.yml -f docker-compose-phpmyadmin.yml -f docker-compose-redis.yml up -d --build --remove-orphans

Configuration and Usage

General Information

This Docker Stack is build for local development and not for production usage.

Configuration

This package comes with default configuration options. You can modify them by creating .env file in your root directory. To make it easy, just copy the content from sample.env file and update the environment variable values as per your need.

Configuration Variables

There are following configuration variables available and you can customize them by overwritting in your own .env file.

PHP

PHPVERSION Is used to specify which PHP Version you want to use. Defaults always to latest PHP Version.

PHP_INI Define your custom php.ini modification to meet your requirments.

Apache

DOCUMENT_ROOT

It is a document root for Apache server. The default value for this is ./docroot. All your sites will go here and will be synced automatically.

DATA_ROOT

A shared drive that syncs data between the host machine and the server. Used for storing files/images that must be kept outside of the docroot.

VHOSTS_DIR

This is for virtual hosts. The default value for this is ./config/vhosts. You can place your virtual hosts conf files here.

Make sure you add an entry to your system's hosts file for each virtual host.

APACHE_LOG_DIR

This will be used to store Apache logs. The default value for this is ./logs/apache2.

Database

DATABASE Define which MySQL or MariaDB Version you would like to use.

MYSQL_DATA_DIR

This is MySQL data directory. The default value for this is ./data/mysql. All your MySQL data files will be stored here.

MYSQL_LOG_DIR

This will be used to store Apache logs. The default value for this is ./logs/mysql.

Web Server

Apache is configured to run on port 80. So, you can access it via http://localhost.

Apache Modules

By default following modules are enabled.

  • rewrite
  • headers

If you want to enable more modules, just update ./bin/webserver/Dockerfile. You can also generate a PR and we will merge if seems good for general purpose. You have to rebuild the docker image by running docker-compose build and restart the docker containers.

Connect via SSH

You can connect to web server using docker-compose exec command to perform various operation on it. Use below command to login to container via ssh.

docker-compose exec webserver bash

PHP

The installed version of depends on your .envfile.

Extensions

By default following extensions are installed. May differ for PHP Verions <7.x.x

  • mysqli
  • pdo_sqlite
  • pdo_mysql
  • mbstring
  • zip
  • intl
  • mcrypt
  • curl
  • json
  • iconv
  • xml
  • xmlrpc
  • gd

If you want to install more extension, just update ./bin/webserver/Dockerfile. You can also generate a PR and we will merge if it seems good for general purpose. You have to rebuild the docker image by running docker-compose build and restart the docker containers.

phpMyAdmin

phpMyAdmin is configured to run on port 8080 by default. Use following default credentials.

http://localhost:8080/
username: root
password: tiger

The port can be changed in the .env with the variable HOST_MACHINE_PHPMYADMIN_PORT=8080

Redis

It comes with Redis. It runs on default port 6379.

Contributing

We are happy if you want to create a pull request or help people with their issues. If you want to create a PR, please remember that this stack is not built for production usage, and changes should good for general purpose and not overspecialized.

Please note that we simplified the project structure from several branches for each php version, to one centralized master branch. Please create your PR against master branch.

Thank you!

Why you shouldn't use this stack unmodified in production

We want to empower developers to quickly create creative Applications. Therefore we are providing an easy to set up a local development environment for several different Frameworks and PHP Versions. In Production you should modify at a minimum the following subjects:

  • php handler: mod_php=> php-fpm
  • secure mysql users with proper source IP limitations
  • create a proper user with permissions, composer runs as root by default