alyamovsky/symfony-docker-skeleton

A project template for Symfony application running inside of Docker containers for convenient development.

3.2.0 2024-10-17 12:08 UTC

MIT

• Andrew Alyamovksy

• template

README

A project template in the following configuration:

1. Latest stable Symfony framework (6.4 at the moment), with the ability to specify the version
2. PHP 8.3
3. PostgreSQL 16.3 (can be altered in the docker compose file) ?
4. Separate Docker containers for Nginx, FPM, CLI and a database
5. CS-Fixer and Psalm on board

The concept

1. The application and docker files are located on the same level: in the /app and /docker folders, respectively. This allows you to separate the symphony-application and docker environment variables, and to implement the mono repository pattern by adding new folders if necessary: /centrifugo, s3-storage, etc.
2. The compose.override.yaml is ignored by default, so you can add your own settings without worrying about overwriting the original ones.

Quick Start

One-liner to create a new project: composer create-project alyamovsky/symfony-docker-skeleton local_project_path && make setup-configs && make init OPTIONS="webapp" && make up

Split into steps:

1. sudo docker run --rm -v $(pwd):/app composer:lts create-project alyamovsky/symfony-docker-skeleton local_project_path (you can also use the composer command from the host machine)
2. make setup-configs - create .env files for docker containers
3. make init OPTIONS="webapp" - very important! Run it before making any commits to your repo. You can omit the OPTIONS parameter if you don't need to use the webapp.
4. make up - start docker containers

Default ports are random (47001-47999) for every created project, so click the link generated in CLI with the output of make up command and enjoy!

You also can set desired ports for Nginx and PostgreSQL manually in generated /.env file (don't forget to run make restart afterwards).

Flags

When running make init, you can use these flags:

• OPTIONS="webapp": Includes web application features. Omit for the basic symfony/skeleton setup.
• VERSION=X.Y: Specifies Symfony version. Defaults to the latest stable version, which is 6.4 at the moment.

Examples:

make init OPTIONS="webapp"
make init VERSION=7.2
make init OPTIONS="webapp" VERSION=7.2

Configuring Xdebug settings for PhpStorm IDE

To integrate Xdebug with PhpStorm within a created project you need to do the following:

1. Create a PHP interpreter in the Settings -> Languages & Frameworks -> PHP tab from the php-fpm container in the project; make sure that Xdebug works properly in the container.
2. Type the port number 9009 at the menu Settings -> Languages & Frameworks -> PHP -> Debug -> Xdebug -> Debug.
3. Create a server named Docker in the menu Settings -> Languages & Frameworks -> PHP -> Servers (it matches with the value of the ServerName field in the IDE config for both interpreters).
4. If necessary, make proper mappings in the PHP interpreter Settings -> Languages & Frameworks -> PHP -> Path Mappings,
5. Click the button Listen for PHP debug connections; if you have any questions, please read the documentation.

Useful makefile commands

1. make console - default shell is zsh with preinstalled set of plugins
2. make test - PHPUnit tests
3. make cs - PHP CS-fixer with predefined rule sets
4. make psalm - Psalm (default level is 1)