OxPHP 上での Drupal

Drupal 11 はクリーン URL を備えたフロントコントローラーとして web/index.php を使用します。ファイル以外のすべてのパスは index.php に書き換えられますが、これはまさに OxPHP のフレームワークルーティングモードそのものです。集約された CSS/JS は web/sites/default/files/ に配置され、他の静的アセットと同様にディスクから配信されます。

スタック概要

OxPHP イメージ: ghcr.io/oxphp/oxphp:0.10.0-php8.4-alpine3.23（PHP 8.4）
ルーティングモード: フレームワーク（ENTRY_FILE=index.php。DOCUMENT_ROOT=/var/www/html/web はデフォルトの …/public を上書きします）
追加した拡張: gd、pdo_mysql、zip、mbstring
サービス: OxPHP + MySQL
URL: http://localhost:8097・内部 http://localhost:9098/health

PHP バージョン

Drupal 11 は PHP 8.3 以上を必要とし、8.4 を公式にサポートしています。その Symfony コンポーネントスタックは PHP 8.5 より前のものなので、このレシピでは PHP 8.4 の OxPHP イメージを固定します。Drupal は mysqli ではなく PDO（pdo_mysql）を使用します。

プロジェクト構成

bash

mkdir -p drupal-oxphp/src
docker run --rm -e COMPOSER_ALLOW_SUPERUSER=1 \
    -v "$PWD/drupal-oxphp/src":/app -w /app \
    composer:2 create-project drupal/recommended-project . \
    --ignore-platform-reqs --no-interaction --prefer-dist
docker run --rm -e COMPOSER_ALLOW_SUPERUSER=1 \
    -v "$PWD/drupal-oxphp/src":/app -w /app \
    composer:2 require drush/drush --ignore-platform-reqs --no-interaction

Note

--ignore-platform-reqs が必要なのは、標準の composer:2 イメージに gd が含まれていないためです。この拡張が必要になるのは実行時だけで、そこでは OxPHP イメージが提供します。

Dockerfile と Compose

src/Dockerfile

ARG OXPHP_VERSION=0.10.0
ARG PHP_VERSION=8.4
ARG ALPINE_VERSION=3.23

# ── PHP base: Drupal runtime extensions ───────────────────────
FROM php:${PHP_VERSION}-zts-alpine${ALPINE_VERSION} AS php-base
RUN apk add --no-cache \
        libpng libjpeg-turbo freetype oniguruma libzip \
    && apk add --no-cache --virtual .build-deps \
        libpng-dev libjpeg-turbo-dev freetype-dev oniguruma-dev libzip-dev \
    && docker-php-ext-configure gd --with-jpeg --with-freetype \
    && docker-php-ext-install -j"$(nproc)" gd pdo_mysql zip mbstring \
    && apk del .build-deps

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

# ── OxPHP artifacts (PHP 8.4 image) ───────────────────────────
FROM ghcr.io/oxphp/oxphp:${OXPHP_VERSION}-php${PHP_VERSION}-alpine${ALPINE_VERSION} AS oxphp

# ── dev: OxPHP server + PHP CLI + Composer + drush ────────────
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 { \
        echo "memory_limit=256M"; echo "upload_max_filesize=64M"; \
        echo "post_max_size=64M"; echo "max_execution_time=300"; \
    } > /usr/local/etc/php/conf.d/drupal.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/web && chown -R www-data:www-data /var/www/html
ENV LD_LIBRARY_PATH=/usr/local/lib
WORKDIR /var/www/html
EXPOSE 80 9090
CMD ["oxphp"]

docker-compose.yml

services:
  app:
    build:
      context: ./src
      target: dev
    image: drupal-oxphp/app:dev
    container_name: drupal-oxphp
    ports:
      - "8097:80"
      - "9098:9090"
    volumes:
      - ./src:/var/www/html
    environment:
      # LISTEN_ADDR defaults to 0.0.0.0:80, so it is omitted.
      DOCUMENT_ROOT: /var/www/html/web   # overrides the default /var/www/html/public
      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:8.0
    container_name: drupal-oxphp-db
    ports:
      - "3312:3306"
    command:
      - --max_allowed_packet=64M
    environment:
      MYSQL_DATABASE: drupal
      MYSQL_USER: drupal
      MYSQL_PASSWORD: drupal
      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: 30
      start_period: 15s
    restart: unless-stopped

volumes:
  db_data:

インストールと初回起動

drush は最もクリーンな非対話式インストーラーです。

bash

docker compose up -d --build
docker compose exec app vendor/bin/drush site:install standard \
    --db-url=mysql://drupal:drupal@db:3306/drupal \
    --account-name=admin --account-pass=admin123 \
    --site-name="Drupal OxPHP" -y

OxPHP に関する注意点

Note

クリーン URL はフレームワークモードそのものです。 Drupal の RewriteCond !-f + RewriteRule ^ index.php は、まさにフレームワークモードが行うこと、つまり既存のファイルを配信し、それ以外のすべてを web/index.php にディスパッチする動作です。
集約されたアセットはディスクから配信されます。 Drupal は結合した CSS/JS を web/sites/default/files/css と …/js に書き出し、OxPHP はそれらを静的ファイルとして配信します。
最初のリクエストは遅く、その後は高速になります。 コールドな初回リクエストは Twig のコンパイル、アセットの集約、そして各種キャッシュをウォームアップします（約 15 秒）。以降のリクエストは 1 桁ミリ秒です。これは Drupal のウォームアップであって、OxPHP のオーバーヘッドではありません。

動作確認

bash

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8097/           # 200
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8097/user/login # 200
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9098/health      # 200

OxPHP 上での Drupal

スタック概要

プロジェクト構成

Dockerfile と Compose

インストールと初回起動

OxPHP に関する注意点

動作確認

関連情報