About | Features | Quick Start | Settings | Development | Composer | MySQL | XDebug | Contributing | License
The Docker4LAMP project is intended to be a minimal but effective Docker based LAMP(Linux,Apache,MySQL,PHP) environment
It is intended to provide everything needed to have a structured development LAMP stack up and running on your workstation with a project layout in place that will allow you to iteratively develop a modern PHP application
- PHP 8.012
- Apache 2
- xdebug-3.1.1 (and documentation for connecting the Visual Studio Code debugger to the container)
- MySQL8
- PhpMyAdmin running by default on port 8080
- Allowance for customization of mysql, php and apache configuration files
- Composer installed in the Server container
- A simple .env file that handles container naming, allowing for multiple unique container setups and port changes through simple text edits
- A preconfigured place to put project development files, that can support modern front-controller framework based applications
- essential documentation
By default your environment is set to provide PHP 8 and MySQL 8. It includes the official phpMyAdmin:latest docker environment for quick web interface access to the MySQL server, and is configured with version 3.x of xdebug, in a configuration that is tested and known to work with VSCode, and should work with other popular editors that support xdebug.
By default your development environment will be available at http://localhost and the phpMyAdmin server will be available at http://localhost:8080. These host ports are documented and can be easily changed in the top level .env file used by docker.
# Get Docker4LAMP git clone https://github.com/gizmola/docker4lamp
Most of the default settings should not need to be changed for your development environment. Change the APP_NAME variable to reflect the name of your new development project. This name is used to create the container names.
In most cases you don't need to change any of the defaults, as this is a development environment running on your workstation!
# /docker4lamp .env file. APP_NAME=your_project
APP_NAME is the base for container names for your project. Set it to something meaningful to avoid conflicts if you want to use docker4Lamp on multiple projects. This setting also helps you see which containers and images are part of your project.
-
Keep in mind that the container names, database users and names are all created when the containers are first built. If you do want to change any defaults, be sure to edit the .env file before your first docker-compose up
-
If you intend to run multiple docker4lamp projects simultaneously, you will have to change the apache and phpmyadmin ports.
-
Switching between projects by using docker-compose up/down doesn't require any changes other than different APP_NAME settings.
-
Once the database is created, if you make changes to the database settings in the .env file, you will have to remove the database container and it's related volume in order to reinitialize the database container. You will lose any data you created if you remove the volume.
# Start the container docker-compose -d up
- Stop your containers using docker-compose down
- Remove the docker4lamp/.git directory.
- Optionally, rename the docker4lamp directory to a project name of your choosing
- start adding code, and/or packages with composer/composer.json
- Add your docker4lamp project to git
Your code goes into the docker4lamp/project directory. Don't change the name of this directory unless you are clear on changes you would need to make to your apache and debug settings
docker4LAMP assumes you will be developing a front controller style app, with the webroot set to the project/ public directory
You can verify the names of your containers from your workstation by running
docker ps
Check the name column of the output. The Apache/PHP container will have a name like: your_project-server
You will substitute the server container name for your project, shown in the name column from the docker ps command
Access the container using Docker exec:
# connect as user www-data docker exec -it -u www-data:www-data -w /var/www/html/project your_project-server /bin/bash
Once you are exec'd in the container you can run composer. This example will create a project composer.json and install the monolog component library
composer require monolog/monolog
docker4lamp creates a database with the same name as your APP_NAME variable.
- hostname: db
- database: APP_NAME
- username: admin
- password: secret
These settings are used by phpMyAdmin to connect to your database. The docker network allows the php/apache server to connect to the database using the hostname db
These credentials can be used with mysqli or PDO to configure the database for development use. docker4LAMP was designed so that you can simply use the database and user created for you.
<?php
try {
$pdo = new \PDO(
'mysql:host=db;dbname=your_project;charset=utf8mb4', 'admin', 'secret',
array(
\PDO::ATTR_EMULATE_PREPARES => false,
\PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION
)
);
Echo "Connected Successfully";
} catch (\PDOException $e) {
throw new \PDOException($e->getMessage(), (int)$e->getCode());
}
If you want to change the defaults, edit the username, password, database settings in the .env file.
If you want to add additional databases, users etc. use docker to connect to the mysql container with docker exec. The mysql container will be named APP_NAME-database. The example below assumes APP_NAME=your_project
# root password: root_secret docker exec -it your_project-database mysql -u root -p your_project
The base server image includes XDebug, as well as a preconfigured xdebug.ini in the server/php/conf.d directory
To debug with VSCode, you must install the PHP Debug Extension by Felix Becker
A verified working VSCode launch.json is included below:
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "Xdebug for Docker",
"type": "php",
"request": "launch",
"port": 9003,
//"stopOnEntry": true,
//"log": true,
"pathMappings": {
"/var/www/html/project": "${workspaceFolder}/project"
}
},
{
"name": "Launch currently open script",
"type": "php",
"request": "launch",
"program": "${file}",
"cwd": "${fileDirname}",
"port": 9003
}
]
}
Copyright (c) 2021 David Rolston