OxPHP 上での Laravel

Laravel は、フレームワークモードのアプリケーションの典型例です。public/index.php にある単一のフロントコントローラーを備え、静的アセットは public/ から直接配信されます。OxPHP のフレームワークルーティングモードは、これにぴったり対応します。ディスク上に存在するファイルはそのまま配信され、それ以外はすべて index.php にディスパッチされます。

スタックの概要

OxPHP イメージ: ghcr.io/oxphp/oxphp:0.10.0 (PHP 8.5)
ルーティングモード: フレームワーク (ENTRY_FILE=index.php、DOCUMENT_ROOT はデフォルトの /var/www/html/public のまま)
追加した拡張: pdo_mysql、intl
サービス: OxPHP + MySQL
URL: http://localhost:8091 · 内部 http://localhost:9092/health

プロジェクト構成

text

laravel-oxphp/
├── docker-compose.yml
└── src/                     # composer create-project laravel/laravel src
    ├── Dockerfile
    └── …                    # the Laravel 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

続いて、src/.env をデータベースサービスに向けます。

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

src/Dockerfile は、Laravel のランタイム拡張を備えた php:8.5-zts-alpine ベースに OxPHP をコピーします。

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:

インストールと初回起動

dev イメージには PHP CLI と Composer が含まれているので、artisan は同じコンテナ内で実行できます。

bash

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

OxPHP に関する補足

Note

ENTRY_FILE=index.php はフレームワークモードを選択します。 Laravel の public/ が DOCUMENT_ROOT になり、フレームワーク自身の .env、app/、vendor/ はドキュメントルートの外に置かれ、HTTP 経由では決してアクセスできません。
コンテナの環境変数が .env を上書きします。 OxPHP はコンテナの環境変数を PHP に渡し、Laravel の dotenv ローダーは実際の環境変数を上書きしません。そのため、Compose で設定した DB_HOST、APP_ENV などが優先されます。
OPcache はリクエストごとに再検証します。 dev ターゲットではこの挙動により、バインドマウントした src/ への編集が即座に反映されます。本番環境では opcache.validate_timestamps=0 を設定し、バインドマウントを外してください。

動作確認

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

OxPHP 上での Laravel

スタックの概要

プロジェクト構成

Dockerfile と Compose

インストールと初回起動

OxPHP に関する補足

動作確認

関連項目