Skip to content

services.md

Latest commit

 

History

History
52 lines (40 loc) · 2.56 KB

services.md

File metadata and controls

52 lines (40 loc) · 2.56 KB
Raw

Services & Devcontainer

Bundled services

Service Version Address
PHP 8.5 —
PostgreSQL 18 127.0.0.1:5432
MySQL 8.4 (LTS) 127.0.0.1:3306
Redis 8 (alpine) 127.0.0.1:6379
Mailpit latest SMTP 127.0.0.1:1025 · Web UI localhost:8025
Caddy latest (via mise) serves the app on localhost:8000

All services share the app container's network namespace (network_mode: "service:app" in .devcontainer/compose.yml), so they are reachable at 127.0.0.1 on their default ports — no hostname resolution needed.

Upgrading from PostgreSQL 17? The postgres-data volume must be recreated — PostgreSQL major versions cannot read older data directories: docker volume rm symfony-poly-stack_postgres-data (PostgreSQL 18+ images mount the volume at /var/lib/postgresql, not /var/lib/postgresql/data; data lives in a major-version subdirectory.)

Toolchain

The Dockerfile only provides PHP-FPM and its extensions. Everything else comes from mise (.mise.toml): Bun, gh, Caddy, Dagger, Claude Code, Codex, and Composer (via the github:composer/composer backend). .devcontainer/setup.sh activates mise in your shell and runs mise install.

Web server

Caddy (Caddyfile) serves public/ on :8000 and forwards PHP requests to PHP-FPM over a Unix socket (/tmp/php-fpm.sock, configured in .devcontainer/config/php-fpm/www.conf). FPM health endpoints are proxied at /fpm-ping and /fpm-status.

GitHub Codespaces

No script rewrites .env. Instead:

  • .mise.toml [env] templates compute DEFAULT_URI (https://$CODESPACE_NAME-8000.$GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN) and set TRUSTED_PROXIES=* when CODESPACE_NAME is present, falling back to the values in .env (or http://localhost:8000) locally.
  • framework.trusted_proxies consumes TRUSTED_PROXIES; router.default_uri consumes DEFAULT_URI (used for URL generation in CLI/scheduler contexts).
  • The Caddyfile forces X-Forwarded-Proto: https behind the Codespaces TLS-terminating proxy (@is_codespace matcher).

This works because php-fpm runs with clear_env = no, and real environment variables always beat .env files in Symfony's Dotenv.