Laravel sur OxPHP

Laravel est l'application canonique en mode framework : un unique contrôleur frontal à public/index.php, avec les fichiers statiques servis directement depuis public/. Le mode de routage framework d'OxPHP s'y adapte exactement. Les fichiers existants sont servis depuis le disque ; tout le reste est acheminé vers index.php.

La 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 : pdo_mysql, intl
Services : OxPHP + MySQL
URL : http://localhost:8091 · interne http://localhost:9092/health

Structure du projet

text

laravel-oxphp/
├── docker-compose.yml
└── src/                     # composer create-project laravel/laravel src
    ├── Dockerfile
    └── …                    # the Laravel application

Générez d'abord l'application :

bash

mkdir -p laravel-oxphp/src
docker run --rm -v "$PWD/laravel-oxphp/src":/app -w /app \
    composer:2 create-project laravel/laravel . --prefer-dist

Pointez ensuite src/.env vers le service de base de données :

src/.env

APP_URL=http://localhost:8091
DB_CONNECTION=mysql
DB_HOST=db
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=laravel

Dockerfile et Compose

src/Dockerfile copie OxPHP dans une base php:8.5-zts-alpine qui embarque les extensions d'exécution de Laravel.

src/Dockerfile

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

# ── PHP base: Laravel runtime extensions ──────────────────────
FROM php:${PHP_VERSION}-zts-alpine${ALPINE_VERSION} AS php-base
RUN apk add --no-cache icu-libs \
    && apk add --no-cache --virtual .build-deps icu-dev \
    && docker-php-ext-install pdo_mysql intl \
    && apk del .build-deps

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

# ── OxPHP artifacts ───────────────────────────────────────────
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
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: laravel-oxphp/app:dev
    container_name: laravel-oxphp
    ports:
      - "8091:80"
      - "9092:9090"
    volumes:
      - ./src:/var/www/html          # live-edit without rebuilding
    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
    depends_on:
      db:
        condition: service_healthy
    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

  db:
    image: mysql:9
    container_name: laravel-oxphp-db
    ports:
      - "3308:3306"
    environment:
      MYSQL_DATABASE: laravel
      MYSQL_USER: laravel
      MYSQL_PASSWORD: laravel
      MYSQL_ROOT_PASSWORD: root
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "-uroot", "-proot"]
      interval: 5s
      timeout: 5s
      retries: 20
      start_period: 15s
    restart: unless-stopped

volumes:
  db_data:

Installation et premier démarrage

L'image dev embarque la CLI PHP et Composer, si bien qu'artisan s'exécute dans le même conteneur :

bash

docker compose up -d --build
docker compose exec app php artisan key:generate
docker compose exec app php artisan migrate

Notes OxPHP

Note

ENTRY_FILE=index.php sélectionne le mode framework. Le public/ de Laravel devient DOCUMENT_ROOT ; les .env, app/ et vendor/ propres au framework restent en dehors de la racine du document et ne sont jamais accessibles via HTTP.
L'environnement du conteneur prime sur .env. OxPHP transmet l'environnement du conteneur à PHP, et le chargeur dotenv de Laravel n'écrase pas les véritables variables d'environnement — de sorte que DB_HOST, APP_ENV, etc. définis dans Compose l'emportent.
OPcache se revalide à chaque requête dans la cible dev, de sorte que les modifications apportées au src/ monté en bind prennent effet immédiatement. En production, définissez opcache.validate_timestamps=0 et supprimez le montage bind.

Vérification

bash

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8091/       # 200
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8091/up     # 200 (health route)
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9092/health # 200

Voir aussi

Routage · Guide Docker · Référence de configuration
Symfony et Yii3 — les autres recettes en mode framework