Drupal Docker

# docker-compose.yml
services:
  php:
    build: { context: ., target: dev, args: { DEV_UID: "${DEV_UID:-1000}", DEV_GID: "${DEV_GID:-1000}" } }
    volumes: [.:/var/www/html, ~/.composer:/root/.composer]
    environment: { MARIADB_HOSTNAME: mariadb, MARIADB_DATABASE: "${MARIADB_DATABASE}", XDEBUG_MODE: "${XDEBUG_MODE:-off}" }
    extra_hosts: ["host.docker.internal:host-gateway"]
    depends_on: { mariadb: { condition: service_healthy } }

  mariadb:
    image: mariadb:11.4
    environment: { MARIADB_ROOT_PASSWORD: "${MARIADB_ROOT_PASSWORD}", MARIADB_DATABASE: "${MARIADB_DATABASE}", MARIADB_USER: "${MARIADB_USER}", MARIADB_PASSWORD: "${MARIADB_PASSWORD}" }
    volumes: [database_data:/var/lib/mysql]
    healthcheck: { test: ["CMD", "mariadb", "-u", "${MARIADB_USER}", "-p${MARIADB_PASSWORD}", "-e", "SELECT 1"], interval: 5s, retries: 10, start_period: 30s }

  caddy:
    image: caddy:2-alpine
    ports: ["80:80", "443:443"]
    volumes: [./Caddyfile:/etc/caddy/Caddyfile:ro, .:/var/www/html:ro, caddy_data:/data]

  maildev: { image: maildev/maildev, ports: ["1080:1080", "1025:1025"] }

volumes: { database_data: {}, caddy_data: {} }

# Dockerfile
FROM php:8.3-apache AS base
RUN apt-get update && apt-get install -y --no-install-recommends \
    libpng-dev libjpeg-dev libwebp-dev libzip-dev git unzip mariadb-client \
    && docker-php-ext-install pdo_mysql gd zip opcache \
    && rm -rf /var/lib/apt/lists/*
RUN a2enmod rewrite

FROM base AS dev
ARG DEV_UID=1000
ARG DEV_GID=1000
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
RUN pecl install xdebug && docker-php-ext-enable xdebug
COPY docker/php/xdebug.ini /usr/local/etc/php/conf.d/xdebug.ini

FROM base AS production
COPY docker/php/opcache-prod.ini /usr/local/etc/php/conf.d/
COPY --chown=www-data:www-data . /var/www/html/
RUN cd /var/www/html && composer install --no-dev --optimize-autoloader --no-interaction

# Makefile
export DEV_UID  := $(shell id -u)
export DEV_GID  := $(shell id -g)

install: build up
	docker compose exec --user www-data php composer install
	docker compose exec --user www-data php drush site:install --yes
	docker compose exec --user www-data php drush cim --yes
	docker compose exec php drush cr

up:     docker compose up -d
down:   docker compose down
build:  docker compose build php
logs:   docker compose logs php -f
shell:  docker compose exec php bash
verify: docker compose exec php drush core:requirements --format=table

# PhpStorm : Settings → PHP → Servers → /var/www/html → chemin local
# VSCode launch.json : "pathMappings": { "/var/www/html": "${workspaceFolder}" }
# Variable : XDEBUG_MODE=debug docker compose up -d (sans rebuild)