Yii3 sur OxPHP

Yii3 est la recette la plus légère de cette série. Le modèle yiisoft/app possède un contrôleur frontal public/index.php, ne nécessite aucune base de données et, comme la plupart du traitement des chaînes est assuré par des polyfills, ne requiert pratiquement aucune extension PHP supplémentaire. Il correspond au mode de routage framework d'OxPHP et s'exécute comme un service unique.

Vue d'ensemble de la pile

Image OxPHP : ghcr.io/oxphp/oxphp:0.13.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 : mbstring (native, pour la rapidité — le runtime la remplace sinon par un polyfill)
Services : OxPHP uniquement
URL : http://localhost:8094 · interne http://localhost:9095/health

Note

yiisoft/app déclare "php": "8.2 - 8.5", l'image PHP 8.5 par défaut convient donc.

Structure du projet

bash

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

Dockerfile et Compose

src/Dockerfile

ARG OXPHP_VERSION=0.13.0
ARG PHP_VERSION=8.5
ARG ALPINE_VERSION=3.23

# ── PHP base: native mbstring ─────────────────────────────────
FROM php:${PHP_VERSION}-zts-alpine${ALPINE_VERSION} AS php-base
RUN apk add --no-cache oniguruma \
    && apk add --no-cache --virtual .build-deps oniguruma-dev \
    && docker-php-ext-install -j"$(nproc)" 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: yii3-oxphp/app:dev
    container_name: yii3-oxphp
    ports:
      - "8094:80"
      - "9095: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
    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

Note

Le modèle yiisoft/app fournit son propre .dockerignore de type liste blanche ; conservez-le. Avec un src/ monté en bind, le COPY n'est qu'un mécanisme de repli.

Installation et premier lancement

bash

docker compose up -d --build
docker compose exec app php yii          # the Yii console

Notes OxPHP

Note

Aucune base de données, aucun service supplémentaire. Le déploiement OxPHP le plus minimal possible : une image, un processus.
yiisoft/assets publie les fichiers statiques dans public/assets/<hash>/. De vrais fichiers sur disque, servis directement par le mode framework. Aucune acrobatie de réécriture d'URL n'est nécessaire (contrairement à certains pipelines d'assets qui intègrent un segment de version dans l'URL).

Vérification

bash

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8094/              # 200
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8094/nonexistent   # 404 (Yii router)
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9095/health         # 200

Prompts pour votre agent

Ces prompts supposent un agent connecté au serveur MCP de la documentation OxPHP — il lira lui-même les pages dont il a besoin.

prompt

Fais tourner mon application Yii3 sur OxPHP en local. Lis la page `examples/framework/yii3` via le serveur MCP de la documentation OxPHP.
Écris le Dockerfile et le fichier Compose pour ce dépôt — la recette est un seul service sans base de données, alors ajoute les services que mon `config/` câble réellement — et donne-moi les commandes de premier lancement.

prompt

Mon application Yii3 tourne sur OxPHP mais ses fichiers publiés renvoient 404. Lis la page `examples/framework/yii3` via le serveur MCP de la documentation OxPHP.
Confronte mes bundles d'assets et le `.dockerignore` de type liste blanche du modèle à la racine du document que définit mon fichier Compose, et dis-moi lequel perd les fichiers.

Voir aussi

Routage · Guide Docker
Laravel et Symfony, les autres recettes en mode framework