OxPHP で動かす Yii3

Yii3 はここで紹介する中で最もシンプルなレシピです。yiisoft/app テンプレートは public/index.php というフロントコントローラーを備え、データベースを必要とせず、また文字列処理のほとんどがポリフィルされているため、追加の PHP 拡張機能も実質的に不要です。OxPHP のフレームワークルーティングモードにそのまま対応し、単一のサービスとして動作します。

スタック概要

  • OxPHP イメージ: ghcr.io/oxphp/oxphp:0.10.0(PHP 8.5)
  • ルーティングモード: フレームワーク(ENTRY_FILE=index.php。DOCUMENT_ROOT はデフォルトの /var/www/html/public のまま)
  • 追加した拡張機能: mbstring(ネイティブ、速度のため。指定しない場合はランタイムがポリフィルします)
  • サービス: OxPHP のみ
  • URL: http://localhost:8094 · 内部 http://localhost:9095/health
Note

yiisoft/app は "php": "8.2 - 8.5" を宣言しているため、デフォルトの PHP 8.5 イメージが適合します。

プロジェクト構成

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 と Compose

src/Dockerfile
ARG OXPHP_VERSION=0.10.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"]
Note

yiisoft/app テンプレートには、ホワイトリスト方式の独自の .dockerignore が同梱されています。これはそのまま残してください。src/ をバインドマウントする場合、COPY はフォールバックにすぎません。

インストールと初回起動

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

OxPHP に関する注意点

Note
  • データベースなし、追加サービスなし。 可能な限り最小の OxPHP デプロイです。イメージ 1 つ、プロセス 1 つ。
  • yiisoft/assets は静的ファイルを public/assets/<hash>/ に publish します。 ディスク上の実ファイルであり、フレームワークモードが直接配信します。URL を書き換えるような小細工は不要です(URL にバージョンセグメントを埋め込む一部のアセットパイプラインとは異なります)。

検証

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

関連情報

間違いを見つけましたか？報告する →