\n ![\"Docker](\"https://jolicode.com/media/original/oss/headers/docker-starter.png\")
\n
\n Docker Starter\n
\n A docker-based infrastructure wrapped in an easy-to-use command line, oriented for PHP projects.
\n
\n\nThis repository contains a collection of Dockerfile and docker-compose configurations\nfor your PHP projects with built-in support for HTTPS, custom domain, databases, workers...\nand is used as a foundation for our projects at [JoliCode](https://jolicode.com/).\n\n> [!WARNING]\n> You are reading the README of version 4 that uses [Castor](https://castor.jolicode.com).\n\n* If you are using [Invoke](https://www.pyinvoke.org/), you can read the [dedicated README](https://github.com/jolicode/docker-starter/tree/v3.11.0);\n* If you are using [Fabric](https://www.fabfile.org/), you can read the [dedicated README](https://github.com/jolicode/docker-starter/tree/v2.0.0);\n\n## Project configuration\n\nBefore executing any command, you need to configure a few parameters in the\n`castor.php` file, in the `create_default_variables()` function:\n\n* `project_name` (**required**): This will be used to prefix all docker objects\n(network, images, containers);\n\n* `root_domain` (optional, default: `project_name + '.test'`): This is the root\ndomain where the application will be available;\n\n* `extra_domains` (optional): This contains extra domains where the application\nwill be available;\n\n* `php_version` (optional, default: `8.5`): This is PHP version.\n\nFor example:\n\n```php\nfunction create_default_variables(): array\n{\n $projectName = 'app';\n $tld = 'test';\n\n return [\n 'project_name' => $projectName,\n 'root_domain' => \"{$projectName}.{$tld}\",\n 'extra_domains' => [\n \"www.{$projectName}.{$tld}\",\n \"admin.{$projectName}.{$tld}\",\n \"api.{$projectName}.{$tld}\",\n ],\n 'php_version' => 8.3,\n ];\n)\n```\n\nWill give you `https://app.test`, `https://www.app.test`,\n`https://api.app.test` and `https://admin.app.test` pointing at your\n`application/` directory.\n\n> [!NOTE]\n> Some castor tasks have been added for DX purposes. Checkout and adapt\n> the tasks `install`, `migrate` and `cache_clear` to your project.\n\n## Usage documentation\n\nWe provide a [README.dist.md](./README.dist.md) to bootstrap your project\ndocumentation, with everything you need to know to start and interact with the\ninfrastructure.\n\nIf you want to install a Symfony project, you can run (before `castor init`):\n\n```\ncastor symfony [--web-app]\n```\n\nTo replace this README with the dist, and remove all unnecessary files, you can\nrun:\n\n```bash\ncastor init\n```\n\n> [!NOTE]\n> This command can be run only once\n\nAlso, in order to improve your usage of castor scripts, you can install console\nautocompletion script.\n\nIf you are using bash:\n\n```bash\ncastor completion | sudo tee /etc/bash_completion.d/castor\n```\n\nIf you are using something else, please refer to your shell documentation. You\nmay need to use `castor completion > /to/somewhere`.\n\nCastor supports completion for `bash`, `zsh` & `fish` shells.\n\n## Cookbooks\n\n### How to install third party tools with Composer\n\n\n\n/composer.json`;\n\n1. create an executable symbolic link to the tool from the root directory of the project: `ln -s ..//vendor/bin/ tools/bin/`;\n\n> [!NOTE]\n> Relative symlinks works here, because the first part of the command is relative to the second part, not to the current directory.\n\nSince `tools/bin` path is appended to the `$PATH`, tools will be available globally in the builder container.\n\n
\n\n### How to change the layout of the project\n\nRead the cookbook
\n\nIf you want to install some third party tools with Composer, it is recommended to install them in their dedicated directory.\nPHPStan and PHP-CS-Fixer are already installed in the `tools` directory.\n\nWe suggest to:\n\n1. create a composer.json which requires only this tool in `tools/\n\n
\n\n### How to use MariaDB instead of PostgreSQL\n\nRead the cookbook
\n\nIf you want to rename the `application` directory, or even move its content to\nthe root directory, you have to edit each reference to it. Theses references\nrepresent each application entry point, whether it be over HTTP or CLI.\nUsually, there is three places where you need to do it:\n\n* In Nginx configuration file:\n `infrastructure/docker/services/php/frontend/etc/nginx/nginx.conf`. You need\n to update `http.server.root` option to the new path. For example:\n ```diff\n - root /var/www/application/public;\n + root /var/www/public;\n ```\n* In all workers configuration file:\n `infrastructure/docker/docker-compose.worker.yml`:\n ```diff\n - command: php -d memory_limit=1G /var/www/application/bin/console messenger:consume async --memory-limit=128M\n + command: php -d memory_limit=1G /var/www/bin/console messenger:consume async --memory-limit=128M\n ```\n* In the builder, to land in the right directory directly:\n `infrastructure/docker/services/php/Dockerfile`:\n ```diff\n - WORKDIR /var/www/application\n + WORKDIR /var/www\n ```\n\n\n\n
\n\n### How to use MySQL instead of PostgreSQL\n\nRead the cookbook
\n\nIn order to use MariaDB, you will need to apply this patch:\n\n```diff\ndiff --git a/infrastructure/docker/docker-compose.builder.yml b/infrastructure/docker/docker-compose.builder.yml\nindex d00f315..bdfdc65 100644\n--- a/infrastructure/docker/docker-compose.builder.yml\n+++ b/infrastructure/docker/docker-compose.builder.yml\n@@ -10,7 +10,7 @@ services:\n builder:\n build: services/builder\n depends_on:\n- - postgres\n+ - mariadb\n environment:\n - COMPOSER_MEMORY_LIMIT=-1\n volumes:\ndiff --git a/infrastructure/docker/docker-compose.worker.yml b/infrastructure/docker/docker-compose.worker.yml\nindex 2eda814..59f8fed 100644\n--- a/infrastructure/docker/docker-compose.worker.yml\n+++ b/infrastructure/docker/docker-compose.worker.yml\n@@ -5,7 +5,7 @@ x-services-templates:\n worker_base: &worker_base\n build: services/worker\n depends_on:\n- - postgres\n+ - mariadb\n #- rabbitmq\n volumes:\n - \"../..:/var/www:cached\"\ndiff --git a/infrastructure/docker/docker-compose.yml b/infrastructure/docker/docker-compose.yml\nindex 49a2661..1804a01 100644\n--- a/infrastructure/docker/docker-compose.yml\n+++ b/infrastructure/docker/docker-compose.yml\n@@ -1,7 +1,7 @@\n version: '3.7'\n\n volumes:\n- postgres-data: {}\n+ mariadb-data: {}\n\n services:\n router:\n@@ -13,7 +13,7 @@ services:\n frontend:\n build: services/frontend\n depends_on:\n- - postgres\n+ - mariadb\n volumes:\n - \"../..:/var/www:cached\"\n labels:\n@@ -24,10 +24,7 @@ services:\n # Comment the next line to be able to access frontend via HTTP instead of HTTPS\n - \"traefik.http.routers.${PROJECT_NAME}-frontend-unsecure.middlewares=redirect-to-https@file\"\n\n- postgres:\n- image: postgres:16\n- environment:\n- - POSTGRES_USER=app\n- - POSTGRES_PASSWORD=app\n+ mariadb:\n+ image: mariadb:11\n+ environment:\n+ - MARIADB_ALLOW_EMPTY_ROOT_PASSWORD=1\n+ healthcheck:\n+ test: \"mariadb-admin ping -h localhost\"\n+ interval: 5s\n+ timeout: 5s\n+ retries: 10\n volumes:\n- - postgres-data:/var/lib/postgresql/data\n+ - mariadb-data:/var/lib/mysql\ndiff --git a/infrastructure/docker/services/php/Dockerfile b/infrastructure/docker/services/php/Dockerfile\nindex 56e1835..95fee78 100644\n--- a/infrastructure/docker/services/php/Dockerfile\n+++ b/infrastructure/docker/services/php/Dockerfile\n@@ -24,7 +24,7 @@ RUN apk add --no-cache \\\n php${PHP_VERSION}-intl \\\n php${PHP_VERSION}-mbstring \\\n- php${PHP_VERSION}-pgsql \\\n+ php${PHP_VERSION}-mysql \\\n php${PHP_VERSION}-xml \\\n php${PHP_VERSION}-zip \\\n```\n\n\n\n
\n\n### How to use with Webpack Encore\n\nRead the cookbook
\n\nIn order to use MySQL, you will need to apply this patch:\n\n```diff\ndiff --git a/infrastructure/docker/docker-compose.builder.yml b/infrastructure/docker/docker-compose.builder.yml\nindex d00f315..bdfdc65 100644\n--- a/infrastructure/docker/docker-compose.builder.yml\n+++ b/infrastructure/docker/docker-compose.builder.yml\n@@ -10,7 +10,7 @@ services:\n builder:\n build: services/builder\n depends_on:\n- - postgres\n+ - mysql\n environment:\n - COMPOSER_MEMORY_LIMIT=-1\n volumes:\ndiff --git a/infrastructure/docker/docker-compose.worker.yml b/infrastructure/docker/docker-compose.worker.yml\nindex 2eda814..59f8fed 100644\n--- a/infrastructure/docker/docker-compose.worker.yml\n+++ b/infrastructure/docker/docker-compose.worker.yml\n@@ -5,7 +5,7 @@ x-services-templates:\n worker_base: &worker_base\n build: services/worker\n depends_on:\n- - postgres\n+ - mysql\n #- rabbitmq\n volumes:\n - \"../..:/var/www:cached\"\ndiff --git a/infrastructure/docker/docker-compose.yml b/infrastructure/docker/docker-compose.yml\nindex 49a2661..1804a01 100644\n--- a/infrastructure/docker/docker-compose.yml\n+++ b/infrastructure/docker/docker-compose.yml\n@@ -1,7 +1,7 @@\n version: '3.7'\n\n volumes:\n- postgres-data: {}\n+ mysql-data: {}\n\n services:\n router:\n@@ -13,7 +13,7 @@ services:\n frontend:\n build: services/frontend\n depends_on:\n- - postgres\n+ - mysql\n volumes:\n - \"../..:/var/www:cached\"\n labels:\n@@ -24,10 +24,7 @@ services:\n # Comment the next line to be able to access frontend via HTTP instead of HTTPS\n - \"traefik.http.routers.${PROJECT_NAME}-frontend-unsecure.middlewares=redirect-to-https@file\"\n\n- postgres:\n- image: postgres:16\n- environment:\n- - POSTGRES_USER=app\n- - POSTGRES_PASSWORD=app\n+ mysql:\n+ image: mysql:8\n+ environment:\n+ - MYSQL_ALLOW_EMPTY_PASSWORD=1\n+ healthcheck:\n+ test: \"mysqladmin ping -h localhost\"\n+ interval: 5s\n+ timeout: 5s\n+ retries: 10\n volumes:\n- - postgres-data:/var/lib/postgresql/data\n+ - mysql-data:/var/lib/mysql\ndiff --git a/infrastructure/docker/services/php/Dockerfile b/infrastructure/docker/services/php/Dockerfile\nindex 56e1835..95fee78 100644\n--- a/infrastructure/docker/services/php/Dockerfile\n+++ b/infrastructure/docker/services/php/Dockerfile\n@@ -24,7 +24,7 @@ RUN apk add --no-cache \\\n php${PHP_VERSION}-intl \\\n php${PHP_VERSION}-mbstring \\\n- php${PHP_VERSION}-pgsql \\\n+ php${PHP_VERSION}-mysql \\\n php${PHP_VERSION}-xml \\\n php${PHP_VERSION}-zip \\\n```\n\n\n\n
\n\n### How to use with AssetMapper\n\nRead the cookbook
\n\n> [!NOTE]\n> this cookbook documents the integration of webpack 5+. For older version\n> of webpack, use previous version of the docker starter.\n\nIf you want to use Webpack Encore in a Symfony project,\n\n1. Follow [instructions on symfony.com](https://symfony.com/doc/current/frontend/encore/installation.html#installing-encore-in-symfony-applications) to install webpack encore.\n\n You will need to follow [these instructions](https://symfony.com/doc/current/frontend/encore/simple-example.html) too.\n\n2. Create a new service for encore:\n\n Add the following content to the `docker-compose.yml` file:\n\n ```yaml\n services:\n encore:\n build:\n context: services/php\n target: builder\n volumes:\n - \"../..:/var/www:cached\"\n command: >\n yarn run dev-server\n --hot\n --host 0.0.0.0\n --public https://encore.${PROJECT_ROOT_DOMAIN}\n --allowed-hosts ${PROJECT_ROOT_DOMAIN}\n --allowed-hosts encore.${PROJECT_ROOT_DOMAIN}\n --client-web-socket-url-hostname encore.${PROJECT_ROOT_DOMAIN}\n --client-web-socket-url-port 443\n --client-web-socket-url-protocol wss\n --server-type http\n labels:\n - \"project-name=${PROJECT_NAME}\"\n - \"traefik.enable=true\"\n - \"traefik.http.routers.${PROJECT_NAME}-encore.rule=Host(`encore.${PROJECT_ROOT_DOMAIN}`)\"\n - \"traefik.http.routers.${PROJECT_NAME}-encore.tls=true\"\n - \"traefik.http.services.encore.loadbalancer.server.port=8000\"\n healthcheck:\n test: [\"CMD\", \"curl\", \"-f\", \"http://localhost:8000/build/app.css\"]\n profiles:\n - default\n ```\n\nIf the assets are not reachable, you may accept self-signed certificate. To do so, open a new tab\nat https://encore.app.test and click on accept.\n\n\n\n
\n\n### How to add Elasticsearch and Kibana\n\nRead the cookbook
\n\n1. Follow [instructions on symfony.com](https://symfony.com/doc/current/frontend/asset_mapper.html#installation) to install AssetMapper.\n\n1. Remove this block in the\n`infrastructure/docker/services/php/frontend/etc/nginx/nginx.conf` file:\n\n ```\n location ~* \\.(jpg|jpeg|png|gif|ico|css|js|svg)$ {\n access_log off;\n add_header Cache-Control \"no-cache\";\n }\n ```\n\n1. Remove these lines in the `infrastructure/docker/services/php/Dockerfile` file:\n\n ```diff\n SHELL [\"/bin/bash\", \"-o\", \"pipefail\", \"-c\"]\n\n - ARG NODEJS_VERSION=18.x\n - RUN curl -s https://deb.nodesource.com/gpgkey/nodesource.gpg.key | gpg --dearmor > /usr/share/keyrings/nodesource.gpg \\\n - && echo \"deb [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_${NODEJS_VERSION} bullseye main\" > /etc/apt/sources.list.d/nodejs.list\n\n # Default toys\n RUN apt-get update \\\n && apt-get install -y --no-install-recommends \\\n git \\\n make \\\n - nodejs \\\n sudo \\\n unzip \\\n && apt-get clean \\\n - && npm install -g yarn@1.22 \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*\n ```\n\n\n`\n* `https://elasticsearch.`\n\nIn your application, you can use the following configuration:\n\n* scheme: `http`;\n* host: `elasticsearch`;\n* port: `9200`.\n\n
\n\n### How to use with Sylius\n\nRead the cookbook
\n\nIn order to use Elasticsearch and Kibana, you should add the following content\nto the `docker-compose.yml` file:\n\n```yaml\nvolumes:\n elasticsearch-data: {}\n\nservices:\n elasticsearch:\n image: elasticsearch:7.8.0\n volumes:\n - elasticsearch-data:/usr/share/elasticsearch/data\n environment:\n - \"discovery.type=single-node\"\n labels:\n - \"traefik.enable=true\"\n - \"project-name=${PROJECT_NAME}\"\n - \"traefik.http.routers.${PROJECT_NAME}-elasticsearch.rule=Host(`elasticsearch.${PROJECT_ROOT_DOMAIN}`)\"\n - \"traefik.http.routers.${PROJECT_NAME}-elasticsearch.tls=true\"\n healthcheck:\n test: \"curl --fail http://localhost:9200/_cat/health || exit 1\"\n interval: 5s\n timeout: 5s\n retries: 5\n profiles:\n - default\n\n kibana:\n image: kibana:7.8.0\n depends_on:\n - elasticsearch\n labels:\n - \"traefik.enable=true\"\n - \"project-name=${PROJECT_NAME}\"\n - \"traefik.http.routers.${PROJECT_NAME}-kibana.rule=Host(`kibana.${PROJECT_ROOT_DOMAIN}`)\"\n - \"traefik.http.routers.${PROJECT_NAME}-kibana.tls=true\"\n profiles:\n - default\n```\n\nThen, you will be able to browse:\n\n* `https://kibana.\n\n
\n\n### How to add RabbitMQ and its dashboard\n\nRead the cookbook
\n\nAdd the php extension `gd` to `infrastructure/docker/services/php/Dockerfile`\n\n```\nphp${PHP_VERSION}-gd \\\n```\n\nIf you want to create a new Sylius project, you need to enter a builder (`inv\nbuilder`) and run the following commands\n\n1. Remove the `application` folder:\n\n ```bash\n cd ..\n rm -rf application/*\n ```\n\n1. Create a new project:\n\n ```bash\n composer create-project sylius/sylius-standard application\n ```\n\n1. Configure the `.env`\n\n ```bash\n sed -i 's#DATABASE_URL.*#DATABASE_URL=postgresql://app:app@postgres:5432/app\\?serverVersion=12\\&charset=utf8#' application/.env\n ```\n\n\n\n` (username: `guest`, password: `guest`)\n\nIn your application, you can use the following configuration:\n\n* host: `rabbitmq`;\n* username: `guest`;\n* password: `guest`;\n* port: `rabbitmq`.\n\nFor example in Symfony you can use: `MESSENGER_TRANSPORT_DSN=amqp://guest:guest@rabbitmq:5672/%2f/messages`.\n\n
\n\n### How to add Redis and its dashboard\n\nRead the cookbook
\n\nIn order to use RabbitMQ and its dashboard, you should add a new service:\n\n```Dockerfile\n# services/rabbitmq/Dockerfile\nFROM rabbitmq:3-management-alpine\n\nCOPY etc/. /etc/\n```\n\nAnd you can add specific RabbitMQ configuration in the `services/rabbitmq/etc/rabbitmq/rabbitmq.conf` file:\n```\n# services/rabbitmq/etc/rabbitmq/rabbitmq.conf\nvm_memory_high_watermark.absolute = 1GB\n```\n\nFinally, add the following content to the `docker-compose.yml` file:\n```yaml\nvolumes:\n rabbitmq-data: {}\n\nservices:\n rabbitmq:\n build: services/rabbitmq\n volumes:\n - rabbitmq-data:/var/lib/rabbitmq\n labels:\n - \"traefik.enable=true\"\n - \"project-name=${PROJECT_NAME}\"\n - \"traefik.http.routers.${PROJECT_NAME}-rabbitmq.rule=Host(`rabbitmq.${PROJECT_ROOT_DOMAIN}`)\"\n - \"traefik.http.routers.${PROJECT_NAME}-rabbitmq.tls=true\"\n - \"traefik.http.services.rabbitmq.loadbalancer.server.port=15672\"\n healthcheck:\n test: \"rabbitmqctl eval '{ true, rabbit_app_booted_and_running } = { rabbit:is_booted(node()), rabbit_app_booted_and_running }, { [], no_alarms } = { rabbit:alarms(), no_alarms }, [] /= rabbit_networking:active_listeners(), rabbitmq_node_is_healthy.' || exit 1\"\n interval: 5s\n timeout: 5s\n retries: 5\n profiles:\n - default\n```\n\nIn order to publish and consume messages with PHP, you need to install the\n`php${PHP_VERSION}-amqp` in the `php` image.\n\nThen, you will be able to browse:\n\n* `https://rabbitmq.\n\n`\n\nIn your application, you can use the following configuration:\n\n* host: `redis`;\n* port: `6379`.\n\n
\n\n### How to add Mailpit\n\nRead the cookbook
\n\nIn order to use Redis and its dashboard, you should add the following content to\nthe `docker-compose.yml` file:\n\n```yaml\nvolumes:\n redis-data: {}\n redis-insight-data: {}\n\nservices:\n redis:\n image: redis:5\n healthcheck:\n test: [\"CMD\", \"redis-cli\", \"ping\"]\n interval: 5s\n timeout: 5s\n retries: 5\n volumes:\n - \"redis-data:/data\"\n profiles:\n - default\n\n redis-insight:\n image: redislabs/redisinsight\n volumes:\n - \"redis-insight-data:/db\"\n labels:\n - \"traefik.enable=true\"\n - \"project-name=${PROJECT_NAME}\"\n - \"traefik.http.routers.${PROJECT_NAME}-redis.rule=Host(`redis.${PROJECT_ROOT_DOMAIN}`)\"\n - \"traefik.http.routers.${PROJECT_NAME}-redis.tls=true\"\n profiles:\n - default\n\n```\n\nIn order to communicate with Redis, you need to install the\n`php${PHP_VERSION}-redis` in the `php` image.\n\nThen, you will be able to browse:\n\n* `https://redis.\n\n`\n\nIn your application, you can use the following configuration:\n\n* scheme: `smtp`;\n* host: `mail`;\n* port: `25`.\n\nFor example in Symfony you can use: `MAILER_DSN=smtp://mail:25`.\n\n
\n\n### How to add Mercure\n\nRead the cookbook
\n\nIn order to use Mailpit and its dashboard, you should add the following content\nto the `docker-compose.yml` file:\n\n```yaml\nservices:\n mail:\n image: axllent/mailpit\n environment:\n - MP_SMTP_BIND_ADDR=0.0.0.0:25\n labels:\n - \"traefik.enable=true\"\n - \"project-name=${PROJECT_NAME}\"\n - \"traefik.http.routers.${PROJECT_NAME}-mail.rule=Host(`mail.${PROJECT_ROOT_DOMAIN}`)\"\n - \"traefik.http.routers.${PROJECT_NAME}-mail.tls=true\"\n - \"traefik.http.services.mail.loadbalancer.server.port=8025\"\n profiles:\n - default\n```\n\nThen, you will be able to browse:\n\n* `https://mail.\n\n
\n\n### How to add redirection.io\n\nRead the cookbook
\n\nIn order to use Mercure, you should add the following content to the\n`docker-compose.yml` file:\n\n```yaml\nservices:\n mercure:\n image: dunglas/mercure\n environment:\n - \"MERCURE_PUBLISHER_JWT_KEY=password\"\n - \"MERCURE_SUBSCRIBER_JWT_KEY=password\"\n - \"ALLOW_ANONYMOUS=1\"\n - \"CORS_ALLOWED_ORIGINS=*\"\n labels:\n - \"traefik.enable=true\"\n - \"project-name=${PROJECT_NAME}\"\n - \"traefik.http.routers.${PROJECT_NAME}-mercure.rule=Host(`mercure.${PROJECT_ROOT_DOMAIN}`)\"\n - \"traefik.http.routers.${PROJECT_NAME}-mercure.tls=true\"\n profiles:\n - default\n```\n\nIf you are using Symfony, you must put the following configuration in the `.env` file:\n\n```\nMERCURE_PUBLISH_URL=http://mercure/.well-known/mercure\nMERCURE_JWT_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjdXJlIjp7InN1YnNjcmliZSI6W10sInB1Ymxpc2giOltdfX0.t9ZVMwTzmyjVs0u9s6MI7-oiXP-ywdihbAfPlghTBeQ\n```\n\n\n\n
\n\n### How to add Blackfire.io\n\nRead the cookbook
\n\nIn order to use redirection.io, you should add the following content to the\n`docker-compose.yml` file to run the agent:\n\n```yaml\nservices:\n redirectionio-agent:\n build: services/redirectionio-agent\n```\n\nAdd the following file `infrastructure/docker/services/redirectionio-agent/Dockerfile`:\n\n```Dockerfile\nFROM alpine:3.12 AS alpine\n\nWORKDIR /tmp\n\nRUN apk add --no-cache wget ca-certificates \\\n && wget https://packages.redirection.io/dist/stable/2/any/redirectionio-agent-latest_any_amd64.tar.gz \\\n && tar -xzvf redirectionio-agent-latest_any_amd64.tar.gz\n\nFROM scratch\n\n# Binary copied from tar\nCOPY --from=alpine /tmp/redirection-agent/redirectionio-agent /usr/local/bin/redirectionio-agent\n\n# Configuration, can be replaced by your own\nCOPY etc /etc\n\n# Root SSL Certificates, needed as we do HTTPS requests to our service\nCOPY --from=alpine /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/\n\nCMD [\"/usr/local/bin/redirectionio-agent\"]\n```\n\nAdd `infrastructure/docker/services/redirectionio-agent/etc/redirectionio/agent.yml`:\n\n```yaml\ninstance_name: \"my-instance-dev\" ### You may want to change this\nlisten: 0.0.0.0:10301\n```\n\nThen you'll need `wget`. In\n`infrastructure/docker/services/php/Dockerfile`, in stage `frontend`:\n\n```Dockerfile\nRUN apt-get update \\\n && apt-get install -y --no-install-recommends \\\n wget \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*\n```\n\nYou can group this command with another one.\n\nThen, **after** installing nginx, you need to install the module:\n\n```Dockerfile\nRUN wget -q -O - https://packages.redirection.io/gpg.key | gpg --dearmor > /usr/share/keyrings/redirection.io.gpg \\\n && echo \"deb [signed-by=/usr/share/keyrings/redirection.io.gpg] https://packages.redirection.io/deb/stable/2 focal main\" | tee -a /etc/apt/sources.list.d/packages_redirection_io_deb.list \\\n && apt-get update \\\n && apt-get install libnginx-mod-redirectionio \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*\n```\n\nFinally, you need to edit\n`infrastructure/docker/services/php/frontend/etc/nginx/nginx.conf` to add the\nfollowing configuration in the `server` block:\n\n```\nredirectionio_pass redirectionio-agent:10301;\nredirectionio_project_key \"AAAAAAAAAAAAAAAA:BBBBBBBBBBBBBBBB\";\n```\n\n**Don't forget to change the project key**.\n\n\n\n
\n\n### How to add support for crons?\n\nRead the cookbook
\n\nIn order to use Blackfire.io, you should add the following content to the\n`docker-compose.yml` file to run the agent:\n\n```yaml\nservices:\n blackfire:\n image: blackfire/blackfire\n environment:\n BLACKFIRE_SERVER_ID: FIXME\n BLACKFIRE_SERVER_TOKEN: FIXME\n BLACKFIRE_CLIENT_ID: FIXME\n BLACKFIRE_CLIENT_TOKEN: FIXME\n profiles:\n - default\n\n```\n\nThen you'll need `wget`. In\n`infrastructure/docker/services/php/Dockerfile`, in stage `base`:\n\n```Dockerfile\nRUN apt-get update \\\n && apt-get install -y --no-install-recommends \\\n wget \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*\n```\n\nYou can group this command with another one.\n\nThen, **after** installing PHP, you need to install the probe:\n\n```Dockerfile\nRUN wget -q -O - https://packages.blackfire.io/gpg.key | gpg --dearmor > /usr/share/keyrings/blackfire.io.gpg \\\n && sh -c 'echo \"deb [signed-by=/usr/share/keyrings/blackfire.io.gpg] http://packages.blackfire.io/debian any main\" > /etc/apt/sources.list.d/blackfire.list' \\\n && apt-get update \\\n && apt-get install -y --no-install-recommends \\\n blackfire-php \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/* \\\n && sed -i 's#blackfire.agent_socket.*#blackfire.agent_socket=tcp://blackfire:8707#' /etc/php/${PHP_VERSION}/mods-available/blackfire.ini\n```\n\nIf you want to profile HTTP calls, you need to enable the probe with PHP-FPM.\nSo in `infrastructure/docker/services/php/Dockerfile`:\n\n```Dockerfile\nRUN phpenmod blackfire\n```\n\nHere also, You can group this command with another one.\n\n\n\n
\n\n### How to run workers?\n\nRead the cookbook
\n\nIn order to set up crontab, you should add a new container:\n\n```Dockerfile\n# services/php/Dockerfile\n\nFROM php-base AS cron\n\nRUN apt-get update \\\n && apt-get install -y --no-install-recommends \\\n cron \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*\n\nCOPY --link cron/crontab /etc/cron.d/crontab\nCOPY --link cron/entrypoint.sh /entrypoint.sh\nENTRYPOINT [\"/entrypoint.sh\"]\n\nCMD [\"cron\", \"-f\"]\n```\n\nAnd you can add all your crons in the `services/php/crontab` file:\n```crontab\n* * * * * php -r 'echo time().PHP_EOL;' > /tmp/cron-stdout 2>&1\n```\n\nAnd you can add the following content to the `services/php/entrypoint.sh` file:\n```bash\n#!/bin/bash\nset -e\n\ngroupadd -g $USER_ID app\nuseradd -M -u $USER_ID -g $USER_ID -s /bin/bash app\n\ncrontab -u app /etc/cron.d/crontab\n\n# Wrapper for logs\nFIFO=/tmp/cron-stdout\nrm -f $FIFO\nmkfifo $FIFO\nchmod 0666 $FIFO\nwhile true; do\n cat /tmp/cron-stdout\ndone &\n\nexec \"$@\"\n```\n\nFinally, add the following content to the `docker-compose.yml` file:\n```yaml\nservices:\n cron:\n build:\n context: services/php\n target: cron\n cache_from:\n - \"type=registry,ref=${REGISTRY:-}/cron:cache\"\n # depends_on:\n # postgres:\n # condition: service_healthy\n env_file: .env\n environment:\n USER_ID: ${USER_ID}\n volumes:\n - \"../..:/var/www:cached\"\n - \"../../.home:/home/app:cached\"\n profiles:\n - default\n```\n\n\n\n
\n\n### How to use PHP FPM status page?\n\nRead the cookbook
\n\nIn order to set up workers, you should define their services in the `docker-compose.worker.yml` file:\n\n```yaml\nservices:\n worker_my_worker:\n <<: *worker_base\n command: /var/www/application/my-worker\n\n worker_date:\n <<: *worker_base\n command: watch -n 1 date\n```\n\n\n\n
\n\n### How to pg_activity for monitoring PostgreSQL\n\nRead the cookbook
\n\nIf you want to use the [PHP FPM status\npage](https://www.php.net/manual/en/fpm.status.php) you need to remove a\nconfiguration block in the\n`infrastructure/docker/services/php/frontend/etc/nginx/nginx.conf` file:\n\n```diff\n- # Remove this block if you want to access to PHP FPM monitoring\n- # dashboarsh (on URL: /php-fpm-status). WARNING: on production, you must\n- # secure this page (by user IP address, with a password, for example)\n- location ~ ^/php-fpm-status$ {\n- deny all;\n- }\n-\n```\n\nAnd if your application uses the front controller pattern, and you want to see\nthe real request URI, you also need to uncomment the following configuration\nblock:\n\n```diff\n- # # Uncomment if you want to use /php-fpm-status endpoint **with**\n- # # real request URI. It may have some side effects, that's why it's\n- # # commented by default\n- # fastcgi_param SCRIPT_NAME $request_uri;\n+ # Uncomment if you want to use /php-fpm-status endpoint **with**\n+ # real request URI. It may have some side effects, that's why it's\n+ # commented by default\n+ fastcgi_param SCRIPT_NAME $request_uri;\n```\n\n\n\n
\n\n### Docker For Windows support\n\nRead the cookbook
\n\nIn order to install pg_activity, you should add the following content to the\n`infrastructure/docker/services/postgres/Dockerfile` file:\n\n```Dockerfile\nRUN apt-get update \\\n && apt-get install -y --no-install-recommends \\\n pg-activity \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*\n```\n\nThen, you can add the following content to the `castor.php` file:\n\n```php\n#[AsTask(description: 'Monitor PostgreSQL', namespace: 'app:db')]\nfunction pg_activity(): void\n{\n docker_compose('exec postgres pg_activity -U app');\n}\n```\n\nFinally you can use the following command:\n\n```\ncastor app:db:pg-activity\n```\n\n\n\n
\n\n### How to access a container via hostname from another container\n\nRead the cookbook
\n\nThis starter kit is compatible with Docker for Windows, so you can enjoy native Docker experience on Windows. You will have to keep in mind some differences:\n\n- You will be prompted to run the env vars manually if you use PowerShell.\n\n\n
\n\n### How to connect networks of two projects\n\nRead the cookbook
\n\nLet's say you have a container (`frontend`) that responds to many hostnames:\n`app.test`, `api.app.test`, `admin.app.test`. And you have another container\n(`builder`) that needs to call the `frontend` with a specific hostname - or with\nHTTPS. This is usually the case when you have a functional test suite.\n\nTo enable this feature, you need to add `extra_hosts` to the `builder` container\nlike so:\n\n```yaml\nservices:\n builder:\n # [...]\n extra_hosts:\n - \"app.test:host-gateway\"\n - \"api.app.test:host-gateway\"\n - \"admin.app.test:host-gateway\"\n```\n\n\n\n
\n\n### How to use FrankenPHP\n\nRead the cookbook
\n\nLet's say you have two projects `foo` and `bar`. You want to run both projects a\nthe same time. And containers from `foo` project should be able to dialog with\n`bar` project via public network (host network).\n\nIn the `foo` project, you'll need to declare the `bar_default` network in\n`docker-compose.yml`:\n\n```yaml\nnetworks:\n bar_default:\n external: true\n```\n\nThen, attach it to the the `foo` router:\n\n```yaml\nservices:\n router:\n networks:\n - default\n - bar_default\n```\n\nFinally, you must remove the constraints on the router so it'll be able to\ndiscover containers from another docker compose project:\n\n```diff\n--- a/infrastructure/docker/services/router/traefik/traefik.yaml\n+++ b/infrastructure/docker/services/router/traefik/traefik.yaml\n providers:\n docker:\n exposedByDefault: false\n- constraints: \"Label(`project-name`,`{{ PROJECT_NAME }}`)\"\n file:\n```\n\nFinally, you must :\n\n1. build the project `foo`\n1. build the project `bar`\n1. Create the network `bar_default` (first time only)\n ```\n docker network create bar_default\n ```\n1. start the project `foo`\n1. start the project `bar`\n\n\n\n
\n\n### How to use a docker registry to cache images layer\n\nRead the cookbook
\n\nMigrating to FrankenPHP involves a lot of changes. You can take inspiration from\nthe following [repostory](https://github.com/lyrixx/async-messenger-mercure)\nand specifically [this commit](https://github.com/lyrixx/async-messenger-mercure/commit/9ac8776253f3950a6c57d457b3742923f9e096a7).\n\n\n\n
\n\n## Credits\n\nDocker-starter logo was created by [Caneco](https://twitter.com/caneco).\n\nRead the cookbook
\n\nYou can use a docker registry to cache images layer, it can be useful to speed\nup the build process during the CI and local development.\n\nFirst you need a docker registry, in following examples we will use the GitHub\nregistry (ghcr.io).\n\nThen add the registry to the context variable of the `castor.php` file:\n\n```php\nfunction create_default_variables(): Context\n{\n return [\n // [...]\n 'registry' => 'ghcr.io/your-organization/your-project',\n ];\n}\n```\n\nOnce you have the registry, you can push the images to the registry:\n\n```bash\ncastor docker:push\n```\n\n> Pushing image cache from a dev environment to a registry is not recommended,\n> as cache may be sensitive to the environment and may not be compatible with\n> other environments. It happens, for example, when you add some build args\n> depending on your environment. It is recommended to push the cache from the CI\n> environment.\n\nThis command will generate a bake file with the images to push from the\n`cache_from` directive of the `docker-compose.yml` file. If you want to add more\nimages to push, you can add the `cache_from` directive to them.\n\n```yaml\nservices:\n my-service:\n build:\n cache_from:\n - \"type=registry,ref=${REGISTRY:-}/my-service:cache\"\n```\n\n#### How to use cached images in a GitHub action\n\n##### Pushing images to the registry from a GitHub action\n\n1. Ensure that the github token have the `write:packages` scope:\n\n```yaml\npermissions:\n contents: read\n packages: write\n```\n\n2. Install Docker buildx in the github action:\n\n```yaml\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v2\n```\n\n3. Login to the registry:\n\n```yaml\n - name: Log in to registry\n shell: bash\n run: echo \"${{ secrets.GITHUB_TOKEN }}\" | docker login ghcr.io -u $ --password-stdin\n```\n\n##### Using the cached images in GitHub action\n\nBy default images are private in the GitHub registry, you will need to login to\nthe registry to pull the images:\n\n```yaml\n - name: Log in to registry\n shell: bash\n run: echo \"${{ secrets.GITHUB_TOKEN }}\" | docker login ghcr.io -u $ --password-stdin\n```\n\n\n
\n![\"JoliCode](\"https://jolicode.com/media/original/oss/footer-github.png?v3\")
\n
\n"
},
{
"path": "application/public/index.php",
"content": " $projectName,\n 'root_domain' => \"{$projectName}.{$tld}\",\n 'extra_domains' => [\n \"www.{$projectName}.{$tld}\",\n ],\n // In order to test docker stater, we need a way to pass different values.\n // You should remove the `$_SERVER` and hardcode your configuration.\n 'php_version' => $_SERVER['DS_PHP_VERSION'] ?? '8.5',\n 'registry' => $_SERVER['DS_REGISTRY'] ?? null,\n ];\n}\n\n#[AsTask(description: 'Builds and starts the infrastructure, then install the application (composer, yarn, ...)')]\nfunction start(): void\n{\n io()->title('Starting the stack');\n\n // workers_stop();\n build();\n install();\n up(profiles: ['default']); // We can't start worker now, they are not installed\n migrate();\n // workers_start();\n\n notify('The stack is now up and running.');\n io()->success('The stack is now up and running.');\n\n about();\n}\n\n#[AsTask(description: 'Installs the application (composer, yarn, ...)', namespace: 'app', aliases: ['install'])]\nfunction install(): void\n{\n io()->title('Installing the application');\n\n $basePath = sprintf('%s/application', variable('root_dir'));\n\n if (is_file(\"{$basePath}/composer.json\")) {\n io()->section('Installing PHP dependencies');\n docker_compose_run('composer install -n --prefer-dist --optimize-autoloader');\n }\n if (is_file(\"{$basePath}/yarn.lock\")) {\n io()->section('Installing Node.js dependencies');\n docker_compose_run('yarn install --frozen-lockfile');\n } elseif (is_file(\"{$basePath}/package.json\")) {\n io()->section('Installing Node.js dependencies');\n\n if (is_file(\"{$basePath}/package-lock.json\")) {\n docker_compose_run('npm ci');\n } else {\n docker_compose_run('npm install');\n }\n }\n if (is_file(\"{$basePath}/importmap.php\")) {\n io()->section('Installing importmap');\n docker_compose_run('bin/console importmap:install');\n }\n\n qa\\install();\n}\n\n#[AsTask(description: 'Update dependencies')]\nfunction update(bool $withTools = false): void\n{\n io()->title('Updating dependencies...');\n\n // docker_compose_run('composer update -o');\n\n if ($withTools) {\n qa\\update();\n }\n}\n\n#[AsTask(description: 'Clears the application cache', namespace: 'app', aliases: ['cache-clear'])]\nfunction cache_clear(bool $warm = true): void\n{\n // io()->title('Clearing the application cache');\n\n // docker_compose_run('rm -rf var/cache/');\n\n // if ($warm) {\n // cache_warmup();\n // }\n}\n\n#[AsTask(description: 'Warms the application cache', namespace: 'app', aliases: ['cache-warmup'])]\nfunction cache_warmup(): void\n{\n // io()->title('Warming the application cache');\n\n // docker_compose_run('bin/console cache:warmup', c: context()->withAllowFailure());\n}\n\n#[AsTask(description: 'Migrates database schema', namespace: 'app:db', aliases: ['migrate'])]\nfunction migrate(): void\n{\n // io()->title('Migrating the database schema');\n\n // docker_compose_run('bin/console doctrine:database:create --if-not-exists');\n // docker_compose_run('bin/console doctrine:migration:migrate -n --allow-no-migration --all-or-nothing');\n}\n\n#[AsTask(description: 'Loads fixtures', namespace: 'app:db', aliases: ['fixtures'])]\nfunction fixtures(): void\n{\n // io()->title('Loads fixtures');\n\n // docker_compose_run('bin/console doctrine:fixture:load -n');\n}\n"
},
{
"path": "infrastructure/docker/docker-compose.dev.yml",
"content": "services:\n router:\n build: services/router\n volumes:\n - \"/var/run/docker.sock:/var/run/docker.sock\"\n - \"./services/router/certs:/etc/ssl/certs\"\n ports:\n - \"80:80\"\n - \"443:443\"\n - \"8080:8080\"\n networks:\n - default\n profiles:\n - default\n"
},
{
"path": "infrastructure/docker/docker-compose.yml",
"content": "# Templates to factorize the service definitions\nx-templates:\n worker_base: &worker_base\n build:\n context: services/php\n target: worker\n user: \"${USER_ID}:${USER_ID}\"\n environment:\n - APP_ENV\n depends_on:\n postgres:\n condition: service_healthy\n volumes:\n - \"../..:/var/www:cached\"\n profiles:\n - worker\n\nvolumes:\n postgres-data: {}\n # # Needed if $XDG_ env vars have been overridden\n # builder-yarn-data: {}\n\nservices:\n postgres:\n image: postgres:16\n environment:\n - POSTGRES_USER=app\n - POSTGRES_PASSWORD=app\n volumes:\n - postgres-data:/var/lib/postgresql/data\n healthcheck:\n test: [\"CMD-SHELL\", \"pg_isready -U postgres\"]\n interval: 5s\n timeout: 5s\n retries: 5\n profiles:\n - default\n\n frontend:\n build:\n context: services/php\n target: frontend\n cache_from:\n - \"type=registry,ref=${REGISTRY:-}/frontend:cache\"\n user: \"${USER_ID}:${USER_ID}\"\n environment:\n - APP_ENV\n volumes:\n - \"../..:/var/www:cached\"\n - \"../../.home:/home/app:cached\"\n depends_on:\n postgres:\n condition: service_healthy\n profiles:\n - default\n labels:\n - \"traefik.enable=true\"\n - \"project-name=${PROJECT_NAME}\"\n - \"traefik.http.routers.${PROJECT_NAME}-frontend.rule=Host(${PROJECT_DOMAINS})\"\n - \"traefik.http.routers.${PROJECT_NAME}-frontend.tls=true\"\n - \"traefik.http.routers.${PROJECT_NAME}-frontend-unsecure.rule=Host(${PROJECT_DOMAINS})\"\n # Comment the next line to be able to access frontend via HTTP instead of HTTPS\n - \"traefik.http.routers.${PROJECT_NAME}-frontend-unsecure.middlewares=redirect-to-https@file\"\n\n # worker_messenger:\n # <<: *worker_base\n # command: php -d memory_limit=1G /var/www/application/bin/console messenger:consume async --memory-limit=128M\n\n builder:\n build:\n context: services/php\n target: builder\n cache_from:\n - \"type=registry,ref=${REGISTRY:-}/builder:cache\"\n init: true\n user: \"${USER_ID}:${USER_ID}\"\n environment:\n - APP_ENV\n # The following list contains the common environment variables exposed by CI platforms\n - GITHUB_ACTIONS\n - CI # Travis CI, CircleCI, Cirrus CI, Gitlab CI, Appveyor, CodeShip, dsari\n - CONTINUOUS_INTEGRATION # Travis CI, Cirrus CI\n - BUILD_NUMBER # Jenkins, TeamCity\n - RUN_ID # TaskCluster, dsari\n volumes:\n - \"../..:/var/www:cached\"\n - \"../../.home:/home/app:cached\"\n # Needed when $XDG_ env vars have overridden, to persist the yarn\n # cache between builder and watcher, adapt according to the location\n # of $XDG_DATA_HOME\n # - \"builder-yarn-data:/data/yarn\"\n depends_on:\n - postgres\n profiles:\n - builder\n"
},
{
"path": "infrastructure/docker/services/php/Dockerfile",
"content": "# hadolint global ignore=DL3008\n\nFROM debian:12.8-slim AS php-base\n\nSHELL [\"/bin/bash\", \"-o\", \"pipefail\", \"-c\"]\n\nRUN apt-get update \\\n && apt-get install -y --no-install-recommends \\\n curl \\\n ca-certificates \\\n gnupg \\\n && curl -sSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb \\\n && dpkg -i /tmp/debsuryorg-archive-keyring.deb \\\n && echo \"deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ bookworm main\" > /etc/apt/sources.list.d/sury.list \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*\n\nRUN apt-get update \\\n && apt-get install -y --no-install-recommends \\\n bash-completion \\\n procps \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*\n\nARG PHP_VERSION\n\nRUN apt-get update \\\n && apt-get install -y --no-install-recommends \\\n \"php${PHP_VERSION}-apcu\" \\\n \"php${PHP_VERSION}-bcmath\" \\\n \"php${PHP_VERSION}-cli\" \\\n \"php${PHP_VERSION}-common\" \\\n \"php${PHP_VERSION}-curl\" \\\n \"php${PHP_VERSION}-iconv\" \\\n \"php${PHP_VERSION}-intl\" \\\n \"php${PHP_VERSION}-mbstring\" \\\n \"php${PHP_VERSION}-pgsql\" \\\n \"php${PHP_VERSION}-uuid\" \\\n \"php${PHP_VERSION}-xml\" \\\n \"php${PHP_VERSION}-zip\" \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*\n\n# Configuration\nCOPY base/php-configuration /etc/php/${PHP_VERSION}\n\nENV PHP_VERSION=${PHP_VERSION}\nENV HOME=/home/app\nENV COMPOSER_MEMORY_LIMIT=-1\n\nWORKDIR /var/www\n\nFROM php-base AS frontend\n\nRUN apt-get update \\\n && apt-get install -y --no-install-recommends \\\n nginx \\\n \"php${PHP_VERSION}-fpm\" \\\n runit \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/* \\\n && rm -r \"/etc/php/${PHP_VERSION}/fpm/pool.d/\"\n\nRUN useradd -s /bin/false nginx\n\nCOPY frontend/php-configuration /etc/php/${PHP_VERSION}\nCOPY frontend/etc/nginx/. /etc/nginx/\nRUN rm -rf /etc/service/\nCOPY frontend/etc/service/. /etc/service/\nRUN chmod 777 /etc/service/*/supervise/\n\nRUN phpenmod app-default \\\n && phpenmod app-fpm\n\nEXPOSE 80\n\nCMD [\"runsvdir\", \"-P\", \"/etc/service\"]\n\nFROM php-base AS worker\n\nFROM php-base AS builder\n\nSHELL [\"/bin/bash\", \"-o\", \"pipefail\", \"-c\"]\n\nARG NODEJS_VERSION=24.x\nRUN curl -s https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /usr/share/keyrings/nodesource.gpg \\\n && echo \"deb [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_${NODEJS_VERSION} nodistro main\" > /etc/apt/sources.list.d/nodesource.list\n\n# Default toys\nENV COREPACK_ENABLE_DOWNLOAD_PROMPT=0\nRUN apt-get update \\\n && apt-get install -y --no-install-recommends \\\n \"git\" \\\n \"make\" \\\n \"nodejs\" \\\n \"php${PHP_VERSION}-dev\" \\\n \"sudo\" \\\n \"unzip\" \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/* \\\n && corepack enable \\\n && yarn set version stable\n\n# Install a fake sudo command\n# This is commented out by default because it exposes a security risk if you use this image in production, but it may be useful for development\n# Use it at your own risk\n# COPY base/sudo.sh /usr/local/bin/sudo\n# RUN curl -L https://github.com/tianon/gosu/releases/download/1.16/gosu-amd64 -o /usr/local/bin/gosu && \\\n# chmod u+s /usr/local/bin/gosu && \\\n# chmod +x /usr/local/bin/gosu && \\\n# chmod +x /usr/local/bin/sudo\n\n# Config\nCOPY builder/php-configuration /etc/php/${PHP_VERSION}\nRUN phpenmod app-default \\\n && phpenmod app-builder\n\n# Composer\nCOPY --from=composer/composer:2.9.5 /usr/bin/composer /usr/bin/composer\n\n# Pie\nRUN curl -L --output /usr/local/bin/pie https://github.com/php/pie/releases/download/1.3.9/pie.phar \\\n && chmod +x /usr/local/bin/pie\n\n# Autocompletion\nADD https://raw.githubusercontent.com/symfony/symfony/refs/heads/7.3/src/Symfony/Component/Console/Resources/completion.bash /tmp/completion.bash\n\n# Composer symfony/console version is too old, and doest not support \"API version feature\", so we remove it\n# Hey, while we are at it, let's add some more completion\nRUN sed /tmp/completion.bash \\\n -e \"s/{{ COMMAND_NAME }}/composer/g\" \\\n -e 's/\"-a{{ VERSION }}\"//g' \\\n -e \"s/{{ VERSION }}/1/g\" \\\n > /etc/bash_completion.d/composer \\\n && sed /tmp/completion.bash \\\n -e \"s/{{ COMMAND_NAME }}/console/g\" \\\n -e \"s/{{ VERSION }}/1/g\" \\\n > /etc/bash_completion.d/console\n\n# Third party tools\nENV PATH=\"$PATH:/var/www/tools/bin\"\n\n# Good default customization\nRUN cat >> /etc/bash.bashrc <\n