This repo is a Docker LAMP environment for local development. You can set up multiple local website and you can easily configure the version of PHP, MySQL or Node.
This environment gives you the basic tools you need for the PHP and frontend development:
- PHP
- Apache
- MySQL/MariaDB
- phpMyAdmin
- Redis
- Node / NPM
- Composer
Note for M1 Mac: at the time of this writing there is no official image of MySQL for M1 chip; please use MariaDB instead.
Credit: This repo is a fork of the awesome repo https://github.com/sprintcube/docker-compose-lamp. This fork adds the support for NODE/NPM and examples.
Updates: Recently added PHP 8.2 and latest stable version of MariaDB.
- Clone this repository on your local computer
- configure .env as needed
- Run the
docker-compose up -d
.
git clone https://github.com/danielefavi/lamp-docker.git
cd lamp-docker/
cp .env.example .env
// modify .env.example as needed
docker-compose up -d
// visit localhost
Your LAMP stack is now ready!! You can access it via http://localhost
.
This Docker Stack is build for local development and not for production usage.
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 .env.example
file and update the environment variable values as per your need.
There are following configuration variables available and you can customize them by overwritting in your own .env
file.
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.
DOCUMENT_ROOT
It is a document root for Apache server. The default value for this is ./www
. All your sites will go here and will be synced automatically.
APACHE_DOCUMENT_ROOT
Apache config file value. The default value for this is /var/www/html.
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
.
For Apple Silicon Users: Please select Mariadb as Database. Oracle doesn't build their SQL Containers for the arm Architecure
DATABASE
Define which MySQL or MariaDB Version you would like to use.
MYSQL_INITDB_DIR
When a container is started for the first time files in this directory with the extensions .sh
, .sql
, .sql.gz
and
.sql.xz
will be executed in alphabetical order. .sh
files without file execute permission are sourced rather than executed.
The default value for this is ./config/initdb
.
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
.
Apache is configured to run on port 80. So, you can access it via http://localhost
.
By default following modules are enabled.
- rewrite
- headers
If you want to enable more modules, just update
./bin/phpX/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 runningdocker-compose build
and restart the docker containers.
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
The installed version of php depends on your .env
file.
By default following extensions are installed. May differ for PHP Versions <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 runningdocker-compose build
and restart the docker containers.
phpMyAdmin is configured to run on port 8080. Use following default credentials.
http://localhost:8080/
username: root
password: tiger
Xdebug comes installed by default and it's version depends on the PHP version chosen in the ".env"
file.
Xdebug versions:
PHP <= 7.3: Xdebug 2.X.X
PHP >= 7.4: Xdebug 3.X.X
To use Xdebug you need to enable the settings in the ./config/php/php.ini
file according to the chosen version PHP.
Example:
# Xdebug 2
#xdebug.remote_enable=1
#xdebug.remote_autostart=1
#xdebug.remote_connect_back=1
#xdebug.remote_host = host.docker.internal
#xdebug.remote_port=9000
# Xdebug 3
#xdebug.mode=debug
#xdebug.start_with_request=yes
#xdebug.client_host=host.docker.internal
#xdebug.client_port=9003
#xdebug.idekey=VSCODE
Xdebug VS Code: you have to install the Xdebug extension "PHP Debug". After installed, go to Debug and create the launch file so that your IDE can listen and work properly.
Example:
VERY IMPORTANT: the pathMappings
depends on how you have opened the folder in VS Code. Each folder has your own configurations launch, that you can view in .vscode/launch.json
{
"version": "0.2.0",
"configurations": [
{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
// "port": 9000, // Xdebug 2
"port": 9003, // Xdebug 3
"pathMappings": {
// "/var/www/html": "${workspaceFolder}/www" // if you have opened VSCODE in root folder
"/var/www/html": "${workspaceFolder}" // if you have opened VSCODE in ./www folder
}
}
]
}
Now, make a breakpoint and run debug.
Tip! After theses configurations, you may need to restart container.
It comes with Redis. It runs on default port 6379
.
Support for https
domains is built-in but disabled by default. There are 3 ways you can enable and configure SSL; https
on localhost
being the easiest. If you are trying to recreating a testing environment as close as possible to a production environment, any domain name can be supported with more configuration.
Notice: For every non-localhost domain name you wish to use https
on, you will need to modify your computers hosts file and point the domain name to 127.0.0.1
. If you fail to do this SSL will not work and you will be routed to the internet every time you try to visit that domain name locally.
To enable https
on localhost
(https://localhost) you will need to:
- Use a tool like mkcert to create an SSL certificate for
localhost
:- With
mkcert
, in the terminal runmkcert localhost 127.0.0.1 ::1
. - Rename the files that were generated
cert.pem
andcert-key.pem
respectively. - Move these files into your docker setup by placing them in
config/ssl
directory.
- With
- Uncomment the
443
vhost inconfig/vhosts/default.conf
.
Done. Now any time you turn on your LAMP container https
will work on localhost
.
If you would like to use normal domain names for local testing, and need https
support, the simplest solution is an SSL certificate that covers all the domain names:
- Use a tool like mkcert to create an SSL certificate that covers all the domain names you want:
- With
mkcert
, in the terminal runmkcert example.com "*.example.org" myapp.dev localhost 127.0.0.1 ::1
where you replace all the domain names and IP addresses to the ones you wish to support. - Rename the files that were generated
cert.pem
andcert-key.pem
respectively. - Move these files into your docker setup by placing them in
config/ssl
directory.
- With
- Uncomment the
443
vhost inconfig/vhosts/default.conf
.
Done. Since you combined all the domain names into a single certificate, the vhost file will support your setup without needing to modify it further. You could add domain specific rules if you wish however. Now any time you turn on your LAMP container https
will work on all the domains you specified.
If you would like your local testing environment to exactly match your production, and need https
support, you could create an SSL certificate for every domain you wish to support:
- Use a tool like mkcert to create an SSL certificate that covers the domain name you want:
- With
mkcert
, in the terminal runmkcert [your-domain-name(s)-here]
replacing the bracket part with your domain name. - Rename the files that were generated to something unique like
[name]-cert.pem
and[name]-cert-key.pem
replacing the bracket part with a unique name. - Move these files into your docker setup by placing them in
config/ssl
directory.
- With
- Using the
443
example from the vhost file (config/vhosts/default.conf
), make new rules that match your domain name and certificate file names.
Done. The LAMP container will auto pull in any SSL certificates in config/ssl
when it starts. As long as you configure the vhosts file correctly and place the SSL certificates in config/ssl
, any time you turn on your LAMP container https
will work on your specified domains.
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 be 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!
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