Docker running Nginx, PHP-FPM, Composer, MySQL and PHPMyAdmin.
-
Before installing project make sure the following prerequisites have been met.
-
We’ll download the code from its repository on GitHub.
-
Configure Nginx With SSL Certificates [Optional]
We'll generate and configure SSL certificate for nginx before running server.
-
Configure Xdebug [Optional]
We'll configure Xdebug for IDE (PHPStorm or Netbeans).
-
By this point we’ll have all the project pieces in place.
-
Use Makefile [Optional]
When developing, you can use
Makefile
for doing recurrent operations. -
When running, you can use docker commands for doing recurrent operations.
For now, this project has been mainly created for Unix (Linux/MacOS)
. Perhaps it could work on Windows.
All requisites should be available for your distribution. The most important are :
Check if docker-compose
is already installed by entering the following command :
which docker-compose
Check Docker Compose compatibility :
The following is optional but makes life more enjoyable :
which make
On Ubuntu and Debian these are available in the meta-package build-essential. On other distributions, you may need to install the GNU C++ compiler separately.
sudo apt install build-essential
You should be careful when installing third party web servers such as MySQL or Nginx.
This project use the following ports :
Server | Port |
---|---|
MySQL | 3306 |
PHPMyAdmin | 8080 |
Nginx | 80 |
Nginx SSL | 443 |
To install Git, download it and install following the instructions :
git clone https://github.com/unixelias/docker-web-dev.git
Go to the project directory :
cd docker-web-dev
.
├── README.md
├── doc
├── lemp-stack
│ ├── Makefile
│ ├── docker-compose.yml
│ ├── db
│ │ ├── dump
│ │ ├── dumps
│ │ ├── Dockerfile
│ ├── etc
│ │ ├── nginx
│ │ │ ├── default.conf
│ │ │ └── default.template.conf
│ │ ├── php
│ │ │ └── php.ini
│ │ └── ssl
│ └── web
│ ├── app
│ │ ├── composer.json.dist
│ │ ├── phpunit.xml.dist
│ │ ├── src
│ │ │ └── Foo.php
│ │ └── test
│ │ ├── FooTest.php
│ │ └── bootstrap.php
│ └── public
│ └── index.php
You can change the host name by editing the .env
file.
If you modify the host name, do not forget to add it to the /etc/hosts
file.
-
Generate SSL certificates
source .env && sudo docker run --rm -v $(pwd)/etc/ssl:/certificates -e "SERVER=$NGINX_HOST" jacoelho/generate-certificate
-
Configure Nginx
Do not modify the
etc/nginx/default.conf
file, it is overwritten byetc/nginx/default.template.conf
Edit nginx file
etc/nginx/default.template.conf
and uncomment the SSL server section :# server { # server_name ${NGINX_HOST}; # # listen 443 ssl; # fastcgi_param HTTPS on; # ... # }
If you use another IDE than PHPStorm or Netbeans, go to the remote debugging section of Xdebug documentation.
For a better integration of Docker to PHPStorm, use the documentation.
-
Get your own local IP address :
sudo ifconfig
-
Edit php file
etc/php/php.ini
and comment or uncomment the configuration as needed. -
Set the
remote_host
parameter with your IP :xdebug.remote_host=192.168.0.1 # your IP
-
Copying the composer configuration file :
cp web/app/composer.json.dist web/app/composer.json
-
Start the application :
sudo docker-compose up -d
Please wait this might take a several minutes...
sudo docker-compose logs -f # Follow log output
-
Open your favorite browser :
- http://localhost
- https://localhost (HTTPS not configured by default)
- http://localhost:8080 PHPMyAdmin (username: dev, password: dev)
-
Stop and clear services
sudo docker-compose down -v
When developing, you can use Makefile for doing the following operations :
Name | Description |
---|---|
apidoc | Generate documentation of API |
clean | Clean directories for reset |
code-sniff | Check the API with PHP Code Sniffer (PSR2) |
composer-up | Update PHP dependencies with composer |
docker-start | Create and start containers |
docker-stop | Stop and clear all services |
gen-certs | Generate SSL certificates for nginx |
logs | Follow log output |
mysql-dump | Create backup of whole database |
mysql-restore | Restore backup from whole database |
test | Test application with phpunit |
Start the application :
sudo make docker-start
Show help :
make help
sudo docker run --rm -v $(pwd)/web/app:/app composer require symfony/yaml
sudo docker run --rm -v $(pwd)/web/app:/app composer update
sudo docker-compose exec -T php ./app/vendor/bin/apigen generate app/src --destination ./app/doc
sudo docker-compose exec -T php ./app/vendor/bin/phpunit --colors=always --configuration ./app/
Checking the standard code with PSR2
sudo docker-compose exec -T php ./app/vendor/bin/phpcs -v --standard=PSR2 ./app/src
sudo docker-compose exec php php -m
sudo docker exec -it mysql bash
and
mysql -u"$MYSQL_ROOT_USER" -p"$MYSQL_ROOT_PASSWORD"
mkdir -p data/db/dumps
source .env && sudo docker exec $(sudo docker-compose ps -q mysqldb) mysqldump --all-databases -u"$MYSQL_ROOT_USER" -p"$MYSQL_ROOT_PASSWORD" > "data/db/dumps/db.sql"
or
source .env && sudo docker exec $(sudo docker-compose ps -q mysqldb) mysqldump test -u"$MYSQL_ROOT_USER" -p"$MYSQL_ROOT_PASSWORD" > "data/db/dumps/test.sql"
source .env && sudo docker exec -i $(sudo docker-compose ps -q mysqldb) mysql -u"$MYSQL_ROOT_USER" -p"$MYSQL_ROOT_PASSWORD" < "data/db/dumps/db.sql"
Connecting MySQL from PDO
<?php
try {
$dsn = 'mysql:host=mysql;dbname=test;charset=utf8;port=3306';
$pdo = new PDO($dsn, 'dev', 'dev');
} catch (PDOException $e) {
echo $e->getMessage();
}
?>
Any thought, feedback or (hopefully not!)
Mantained by @unixelias
Forked from @letvinz