Symfony sur OxPHP

Le contrôleur frontal public/index.php de Symfony s'intègre directement au mode routage framework d'OxPHP. Le symfony/skeleton ne nécessite aucune base de données, il s'agit donc d'un déploiement à service unique. Vous ajouterez Doctrine et un service db plus tard, quand vous mettrez en place la persistance.

Le stack en un coup d'œil

Image OxPHP : ghcr.io/oxphp/oxphp:0.10.0 (PHP 8.5)
Mode de routage : Framework (ENTRY_FILE=index.php ; DOCUMENT_ROOT laissé à sa valeur par défaut /var/www/html/public)
Extensions ajoutées : intl, mbstring (la base recommandée par Symfony ; le runtime n'a strictement besoin que des extensions du cœur)
Services : OxPHP uniquement
URL : http://localhost:8096 · interne http://localhost:9097/health

Version de PHP

Symfony 8 déclare "php": ">=8.4", ce que l'image PHP 8.5 par défaut satisfait. Vérifiez qu'une dépendance ne plafonne pas la borne supérieure avec composer check-platform-reqs --no-dev.

Structure du projet

bash

mkdir -p symfony-oxphp/src
docker run --rm -e COMPOSER_ALLOW_SUPERUSER=1 \
    -v "$PWD/symfony-oxphp/src":/app -w /app \
    composer:2 create-project symfony/skeleton . --prefer-dist
# optional, for a rendered page:
docker run --rm -e COMPOSER_ALLOW_SUPERUSER=1 \
    -v "$PWD/symfony-oxphp/src":/app -w /app \
    composer:2 require twig symfony/asset

Dockerfile et fichier compose

src/Dockerfile

ARG OXPHP_VERSION=0.10.0
ARG PHP_VERSION=8.5
ARG ALPINE_VERSION=3.23

# ── PHP base: intl + mbstring ─────────────────────────────────
FROM php:${PHP_VERSION}-zts-alpine${ALPINE_VERSION} AS php-base
RUN apk add --no-cache icu-libs oniguruma \
    && apk add --no-cache --virtual .build-deps icu-dev oniguruma-dev \
    && docker-php-ext-install -j"$(nproc)" intl mbstring \
    && apk del .build-deps

# ── Composer ──────────────────────────────────────────────────
FROM composer:2 AS composer

# ── OxPHP artifacts (PHP 8.5 default image) ───────────────────
FROM ghcr.io/oxphp/oxphp:${OXPHP_VERSION} AS oxphp

# ── dev: OxPHP server + PHP CLI + Composer ────────────────────
FROM php-base AS dev
RUN apk add --no-cache libgcc git
COPY --from=composer /usr/bin/composer /usr/local/bin/composer
COPY --from=oxphp /usr/local/bin/oxphp              /usr/local/bin/oxphp
COPY --from=oxphp /usr/local/lib/liboxphp_bridge.so /usr/local/lib/
COPY --from=oxphp /usr/local/lib/php/extensions/ /tmp/oxphp-ext/
RUN cp /tmp/oxphp-ext/*/oxphp_sapi.so "$(php -r 'echo ini_get("extension_dir");')/" \
    && rm -rf /tmp/oxphp-ext \
    && echo "extension=oxphp_sapi.so" > /usr/local/etc/php/conf.d/oxphp-ext.ini
RUN { \
        echo "[opcache]"; echo "opcache.enable=1"; echo "opcache.enable_cli=1"; \
        echo "opcache.validate_timestamps=1"; echo "opcache.revalidate_freq=0"; \
    } > /usr/local/etc/php/conf.d/opcache-dev.ini
RUN getent passwd www-data >/dev/null \
    || adduser -D -H -u 82 -G www-data -s /sbin/nologin www-data
RUN mkdir -p /var/www/html/public && chown -R www-data:www-data /var/www/html
ENV LD_LIBRARY_PATH=/usr/local/lib
WORKDIR /var/www/html
COPY --chown=www-data:www-data . /var/www/html
EXPOSE 80 9090
CMD ["oxphp"]

docker-compose.yml

services:
  app:
    build:
      context: ./src
      target: dev
    image: symfony-oxphp/app:dev
    container_name: symfony-oxphp
    ports:
      - "8096:80"
      - "9097:9090"
    volumes:
      - ./src:/var/www/html
    environment:
      # LISTEN_ADDR (0.0.0.0:80) and DOCUMENT_ROOT (/var/www/html/public) are
      # the OxPHP defaults, so both are omitted.
      ENTRY_FILE: index.php          # framework mode
      INTERNAL_ADDR: 0.0.0.0:9090
      ACCESS_LOG: all
      APP_ENV: dev
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "wget", "-q", "--spider", "http://0.0.0.0:9090/health"]
      interval: 10s
      timeout: 3s
      retries: 5
      start_period: 5s

Installation et premier lancement

bash

docker compose up -d --build
docker compose exec app php bin/console about

Notes OxPHP

Note

Empreinte minimale des extensions. Le runtime du skeleton Symfony n'a besoin que des extensions du cœur (ctype, iconv, xml), toutes présentes dans l'image de base — mbstring est sinon fournie par un polyfill. Les extensions natives intl + mbstring sont ajoutées parce que toute vraie application Symfony les utilise et que les versions natives sont plus rapides que le polyfill.
APP_ENV depuis l'environnement du conteneur. Symfony le lit depuis l'environnement réel plutôt que depuis .env, alors définissez-le dans Compose.
Les fichiers statiques sont servis depuis public/ par le mode framework — {{ asset('css/app.css') }} se résout vers un vrai fichier sur le disque et est servi directement, ne retombant sur index.php qu'en cas d'absence.

Vérification

bash

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8096/             # 200
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8096/no-such-route # 404 (Symfony router)
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9097/health        # 200

Voir aussi

Routage · Guide Docker
Laravel et Yii3 — les autres recettes en mode framework