在 OxPHP 上运行 Craft CMS

Craft CMS 使用 web/index.php 作为前端控制器，并从 web/cpresources/ 提供控制面板资源。它运行在 OxPHP 的框架路由模式下：已存在的静态文件（包括控制面板资源）直接从磁盘提供，其余请求全部分派给 index.php。

技术栈一览

  • OxPHP 镜像： ghcr.io/oxphp/oxphp:0.10.0（PHP 8.5）
  • 路由模式： 框架模式（ENTRY_FILE=index.php；DOCUMENT_ROOT=/var/www/html/web 覆盖了默认的 …/public）
  • 新增扩展： bcmath、gd、intl、pdo_mysql、mbstring、zip
  • 服务： OxPHP + MySQL（8.4 LTS）
  • URL： http://localhost:8092 · 控制面板 /admin · 内部 http://localhost:9093/health

项目结构

bash
mkdir -p craft-oxphp/src docker run --rm -v "$PWD/craft-oxphp/src":/app -w /app \ composer:2 create-project craftcms/craft . \ --ignore-platform-reqs --no-scripts --no-interaction --prefer-dist
Note

这里需要 --ignore-platform-reqs --no-scripts，因为原版 composer:2 镜像缺少 bcmath/gd/intl；这些扩展只在运行时才需要，而 Craft 的创建后安装向导会在稍后、在构建好的容器内部运行。

Craft 从环境变量读取数据库连接信息，因此除了控制台写入的那些键之外，无需再编辑 .env。

Dockerfile 与 Compose

下面同时给出两个文件；Dockerfile 位于 src/Dockerfile。

src/Dockerfile
ARG OXPHP_VERSION=0.10.0 ARG PHP_VERSION=8.5 ARG ALPINE_VERSION=3.23 # ── PHP base: Craft runtime extensions ──────────────────────── FROM php:${PHP_VERSION}-zts-alpine${ALPINE_VERSION} AS php-base RUN apk add --no-cache \ icu-libs libpng libjpeg-turbo freetype oniguruma libzip \ && apk add --no-cache --virtual .build-deps \ icu-dev 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)" bcmath gd intl pdo_mysql mbstring zip \ && 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 + Craft extensions ── 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 { \ echo "memory_limit=256M"; echo "upload_max_filesize=64M"; \ echo "post_max_size=64M"; echo "max_execution_time=120"; \ } > /usr/local/etc/php/conf.d/craft.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 COPY --chown=www-data:www-data . /var/www/html EXPOSE 80 9090 CMD ["oxphp"]

安装与首次运行

Craft 通过其控制台进行安装，控制台就在同一个容器内：

bash
docker compose up -d --build docker compose exec app php craft setup/security-key # writes CRAFT_SECURITY_KEY docker compose exec app php craft setup/app-id # writes CRAFT_APP_ID docker compose exec app php craft install/craft \ --username=admin [email protected] --password=password \ --site-name="Craft OxPHP" --site-url='http://localhost:8092' --language=en-US

OxPHP 注意事项

Note
  • 控制面板资源是静态文件。 web/cpresources/<hash>/… 存在于磁盘上，由框架模式直接提供 —— 请确认它返回 200，否则控制面板会加载不出样式。
  • 使用 MySQL 8.4 LTS，而不是 MySQL 9。 Craft 已针对 MySQL 8.x 完成验证；8.4 LTS 镜像是稳妥之选。（MySQL 8.4 已移除服务器端的 --default-authentication-plugin 标志 —— 不要再传入它。）
  • 数据库设置来自容器环境变量（CRAFT_DB_*），因此它们放在 Compose 中。

验证

bash
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8092/ # 200 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8092/admin # 302 → login curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9093/health # 200

另请参阅

发现错误？报告问题 →