Docker Compose PHP 8.4 Starter

readme.md

Uses FrankenPHP

Use with Caddy Docker Proxy Stack (gist) for easy URLs like example.localhost

Includes XDebug & Composer

Find the ID of your user and group:

id -u
id -g

Populate WWW_UID & WWW_GID build args in compose.yml with your IDs

Start your stack

docker compose up

Don't forget to tell your app to trust the proxy headers: https://laravel.com/docs/12.x/requests#configuring-trusted-proxies

Put the vscode-launch.json at .vscode/launch.json

Put the index.php at public/index.php

compose.yml

services:
  app:
    build:
      context: .
      args:
        # Your own user's UID and GID on the host
        WWW_UID: 1000 # Run `id -u` to find yours
        WWW_GID: 1000 # Run `id -g` to find yours
    tty: true # Nice coloured logs
    volumes:
      - $PWD:/app
    environment:
      SERVER_NAME: ":80" # The address Caddy will listen on
      CADDY_GLOBAL_OPTIONS: |
        debug
        servers {
          trusted_proxies static private_ranges
        }
    networks:
      - default
      - caddy
    labels:
      caddy: docker-php.localhost
      caddy.reverse_proxy: "{{upstreams 80}}"

networks:
  caddy:
    external: true

Dockerfile

FROM dunglas/frankenphp:php8.4-bookworm

ARG WWW_UID=33
ARG WWW_GID=33

RUN install-php-extensions \
	@composer \
	intl \
	zip \
	opcache \
	xdebug

ENV XDEBUG_MODE=
COPY <<-INI /usr/local/etc/php/conf.d/xdebug.ini
	[xdebug]
	xdebug.max_nesting_level = 512
	xdebug.profiler_output_name = cachegrind.xdebug-profile-%H-%t-%r
	xdebug.mode = debug,develop
	xdebug.discover_client_host = 1
	xdebug.start_with_request = trigger
	xdebug.log = /app/storage/logs/xdebug.log
	xdebug.output_dir = /app/storage/logs/xdebug
INI
COPY <<-INI /usr/local/etc/php/conf.d/opcache.ini
	[opcache]
	opcache.enable = 1
	opcache.huge_code_pages = 1
	; Check the timestamp of the files to invalidate the cache
	opcache.validate_timestamps = 1
	; Update the cache on every request
	opcache.revalidate_freq = 0
INI

# Modify existing www-data user
RUN usermod -u ${WWW_UID} www-data \
	&& groupmod -g ${WWW_GID} www-data \
	&& setcap CAP_NET_BIND_SERVICE=+eip /usr/local/bin/frankenphp \
	&& chown -R www-data:www-data /data/caddy /config/caddy

USER www-data

index.php

<?php

phpinfo();

vscode-launch.json

{
	// Use IntelliSense to learn about possible attributes.
	// Hover to view descriptions of existing attributes.
	// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
	"version": "0.2.0",
	"configurations": [
		{
			"name": "Listen for Xdebug",
			"type": "php",
			"request": "launch",
			"port": 9003,
			"pathMappings": {
				"/app": "${workspaceFolder}"
			}
		}
	]
}