improved documentation

Author: mbelchin

README.md

@@ -1,23 +1,138 @@
-# lemp-docker-compose
+# docker-php-nginx-mysql-postgres-composer
 
-Fully LEMP working environment for Docker compose.
+Docker Compose configuration to run PHP, Nginx, PHP-FPM, MySQL, PostgreSQL, Composer and Symfony
 
 PHP 7.4.14
 
 Nginx 1.18
 
-Mysql 8.0.23
+MySQL 8.0.23
 
-## Pre-requisites
+PostgreSQL 13.1
 
-You must have docker desktop running on your computer. Follow instalation instructions from here:
+## Overview
+
+This Docker Compose configuration allows you to run PHP 7.4 with Nginx 1.18, PHP-FPM, MySQL 8.0.23 and PostgreSQL 13.1, Composer and Symfony.
+
+It exposes 5 services:
+
+nginx
+php-fom
+mysql
+postgres
+composer
+
+To know all extensions enabled for PHP you can run it using `docker-compose up`and visit: http://localhost/phpinfo.php and check the PHP info.
+
+The UUID extension for PostgreSQL has been added.
+
+Nginx includes default configuration for Symfony 5.
+
+Composer runs during boot to install the vendors.
+
+Symfony command is available.
+
+
+## Prerequisites
+
+You must have docker running on your computer. Follow instalation instructions from here:
 
 https://docs.docker.com/desktop/
 
+
+## How to use it
+
+### Start docker compose
+
+Checkout this repo or download it.
+
+Just run `docker-compose up`
+
+By default nginx will be available on `http://localhost:80`, PostgreSQL on `http://localhost:5432` and MySQL on `http://localhost:3306`
+
+### Use nginx
+
+You can run some nginx commands when needed, i.e.:
+
+`docker-compose exec nginx nginx -v`
+
+### Use Composer
+
+You can run composer commands, i.e.:
+
+`docker-compose run composer <composer-command>`
+
+`docker-compose run composer -V`
+
+### Use Symfony
+
+You can run symfony commands, i.e.:
+
+`docker-compose exec php-fpm symfony <symfony-command>`
+
+For instance, you can check symfony requirements:
+
+`docker-compose exec php-fpm symfony check:req`
+
+### Use PHP
+
+`docker-compose exec php-fpm php -v`
+
+### Use PostgreSQL
+
+You can run postgres commands, i.e.:
+
+`docker-compose exec postgres postgres -V`
+
+And work with your DBs:
+
+`docker-compose exec postgres psql -d testdb -U myuser`
+
+### Use MySQL
+
+You can run mysql commands, i.e.:
+
+`docker-compose exec mysql mysql -V`
+
+And work with your DBs:
+
+`docker-compose exec mysql mysql -u root -pmyrootpassword`
+
+
+
 ## Configuration
 
-Check docker-compose.yml and change the volume for nginx and php-fpm where you have your code, by default it's serving from `src/` folder a default phpinfo() file.
+### Configuring volumes
+
+By default when you run `docker-compose up` it's attaching the `src/` folder as volume. It will be the folder used to serve the source code.
+
+Check `docker-compose.yml` and change the volumes for nginx and php-fpm where you have your code.
+
+You can change `./src/` under `volumes:` to any other folder in your system.
+
+```
+volumes:
+  - ./src/:/var/www/
+```
+
+For instance:
+
+```
+volumes:
+  - ../my-symfony-project/:/var/www/
+```
+
+### Configuring DBs
+
+The `docker-compose.yml` runs both MySQL and PostgreSQL but if you want to use only one you can comment the code out (or delete it) the DB you don't want to use in `docker-compose.yml` file.
+
+The `.env` file contains the sensitive user & password information for connecting to the DBs.
+
+Modify `.env` file default parameters according to your needs.
+
+### Configuring PHP
+
+You can enable/disable any PHP directive just by editing these files:
 
-## Get up & running
+`./php-fpm/conf.d/php.ini` or `./php-fpm/conf.d/xdebug.ini`
 
-Just run `docker-compose up`