start_sf5_project/README.md

Docker environment for a Symfony5 project

Add to your project

Move the docker-compose.yml and the folder named docker_build containing nginx and php-fpm config for it to the root of your Symfony project.

Ensure the webserver config on docker\nginx.conf is correct for your project. For instance, for Symfony 4 or 5 it should look for the public/index.php, instead of the web/app.php from Symfony2 and Symfony3

Note: you may place the files elsewhere in your project. Make sure you modify the locations for the php-fpm dockerfile, the php.ini overrides and nginx config on docker-compose.yml if you do so.

How to run

Dependencies:

• Docker engine v1.13 or higher. Your OS provided package might be a little old, if you encounter problems, do upgrade. See https://docs.docker.com/engine/installation
• Docker compose v1.12 or higher. See docs.docker.com/compose/install

Once you're done, simply cd to your project and run docker-compose up -d. This will initialise and start all the containers, then leave them running in the background.

Docker compose cheatsheet

Note: you need to cd first to where your docker-compose.yml file lives.

• Start containers in the background: docker-compose up -d
• Start containers on the foreground: docker-compose up. You will see a stream of logs for every container running.
• Stop containers: docker-compose stop
• Kill containers: docker-compose kill
• View container logs: docker-compose logs
• Execute command inside of container: docker-compose exec SERVICE_NAME COMMAND where COMMAND is whatever you want to run. Examples: * Shell into the PHP container, docker-compose exec php bash * Run symfony console, docker-compose exec php bin/console * Open a postgresql shell, docker-compose exec db psql --user admin postgres

Docker general cheatsheet

Note: these are global commands and you can run them from anywhere.

• To clear containers: docker rm -f $(docker ps -a -q)
• To clear images: docker rmi -f $(docker images -a -q)
• To clear volumes: docker volume rm $(docker volume ls -q)
• To clear networks: docker network rm $(docker network ls | tail -n+2 | awk '{if($2 !~ /bridge|none|host/){ print $1 }}')

Disclaimer: This project has been generated on phpdocker.io

Installation

• docker-compose up -d
• in php container docker-compose exec php bash
  • composer create-project symfony/skeleton symfony
  • mv symfony/* .
  • mv symfony/.* .
  • rm -Rf symfony
  • composer require annotations
  • composer require --dev profiler
  • composer require twig
  • composer require orm
  • composer require form
  • composer require form validator
  • composer require maker-bundle
• docker-compose down
• adapt querystring in ./app/.env:

  --- DATABASE_URL="postgresql://db_user:db_password@127.0.0.1:5432/db_name?serverVersion=13&charset=utf8"
  +++ DATABASE_URL="postgresql://admin:secret@db:5432/postgres?serverVersion=12&charset=utf8"
  

• docker-compose up -d
• in php container docker-compose exec php bash
  • bin/console doctrine:schema:create