GitHub

在 OxPHP 上运行 Yii3

Yii3 是这里最精简的方案。yiisoft/app 模板带有一个 public/index.php 前端控制器，无需数据库，而且由于大部分字符串处理都通过 polyfill 实现，基本不需要额外的 PHP 扩展。它对应到 OxPHP 的框架路由模式，并作为单个服务运行。

技术栈一览

  • OxPHP 镜像： ghcr.io/oxphp/oxphp:0.13.0（PHP 8.5）
  • 路由模式： 框架模式（ENTRY_FILE=index.php；DOCUMENT_ROOT 保持默认值 /var/www/html/public）
  • 新增扩展： mbstring（原生扩展，为提升速度——否则运行时会用 polyfill 替代它）
  • 服务： 仅 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.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"]
Note

yiisoft/app 模板自带一份白名单风格的 .dockerignore；请保留它。在使用绑定挂载的 src/ 时，COPY 只是一个后备手段。

安装与首次运行

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

OxPHP 说明

Note
  • 无数据库，无额外服务。 这是可能的最小 OxPHP 部署：一个镜像，一个进程。
  • yiisoft/assets 会把静态文件发布到 public/assets/<hash>/。 这些是磁盘上的真实文件，由框架模式直接提供服务。无需任何 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

给你的智能体的提示词

这些提示词假定你的智能体已连接 OxPHP 文档 MCP 服务器——需要哪些页面它会自己去读。

prompt
在本地把我的 Yii3 应用跑在 OxPHP 上。通过 OxPHP 文档 MCP 服务器读取 `examples/framework/yii3` 页面。 为这个仓库写好 Dockerfile 和 Compose 文件——这份方案是不带数据库的单个服务，所以要把我的 `config/` 实际接上的那些服务加进来——并给我首次运行的命令。
prompt
我的 Yii3 应用在 OxPHP 上能跑，但它发布出来的资源返回 404。通过 OxPHP 文档 MCP 服务器读取 `examples/framework/yii3` 页面。 拿我的资源包和模板自带的白名单式 `.dockerignore`，去对照我 Compose 文件设置的文档根目录，告诉我是哪一个把文件弄丢了。

另请参阅

发现错误？报告问题 →