在 OxPHP 上运行 Symfony

Symfony 的 public/index.php 前端控制器可以直接接入 OxPHP 的框架路由模式。symfony/skeleton 不需要数据库，因此这是一个单服务部署。等你后续接入持久化时，再添加 Doctrine 和一个 db 服务即可。

技术栈概览

  • OxPHP 镜像： ghcr.io/oxphp/oxphp:0.10.0（PHP 8.5）
  • 路由模式： 框架模式（ENTRY_FILE=index.php；DOCUMENT_ROOT 保持默认值 /var/www/html/public）
  • 新增扩展： intl、mbstring（Symfony 推荐的基线；运行时严格来说只需要核心扩展）
  • 服务： 仅 OxPHP
  • URL： http://localhost:8096 · 内部 http://localhost:9097/health
PHP 版本

Symfony 8 声明了 "php": ">=8.4"，默认的 PHP 8.5 镜像满足该要求。用 composer check-platform-reqs --no-dev 确认没有依赖对上限版本设限。

项目结构

bash
mkdir -p symfony-oxphp/src docker run --rm -e COMPOSER_ALLOW_SUPERUSER=1 \ -v "$PWD/symfony-oxphp/src":/app -w /app \ composer:2 create-project symfony/skeleton . --prefer-dist # optional, for a rendered page: docker run --rm -e COMPOSER_ALLOW_SUPERUSER=1 \ -v "$PWD/symfony-oxphp/src":/app -w /app \ composer:2 require twig symfony/asset

Dockerfile 和 compose 文件

src/Dockerfile
ARG OXPHP_VERSION=0.10.0 ARG PHP_VERSION=8.5 ARG ALPINE_VERSION=3.23 # ── PHP base: intl + mbstring ───────────────────────────────── FROM php:${PHP_VERSION}-zts-alpine${ALPINE_VERSION} AS php-base RUN apk add --no-cache icu-libs oniguruma \ && apk add --no-cache --virtual .build-deps icu-dev oniguruma-dev \ && docker-php-ext-install -j"$(nproc)" intl 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"]

安装并首次运行

bash
docker compose up -d --build docker compose exec app php bin/console about

OxPHP 说明

Note
  • 扩展占用极小。 Symfony skeleton 的运行时只需要核心扩展（ctype、iconv、xml），它们都已存在于基础镜像中 —— mbstring 在其他情况下由 polyfill 提供。之所以添加原生的 intl + mbstring，是因为任何真实的 Symfony 应用都会用到它们，而且原生版本比 polyfill 更快。
  • APP_ENV 来自容器环境。 Symfony 会优先从真实环境读取它，而非 .env，所以要在 Compose 里设置。
  • 静态资源由框架模式从 public/ 提供 —— {{ asset('css/app.css') }} 会解析为磁盘上的真实文件并被直接提供，只有在未命中时才会回退到 index.php。

验证

bash
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8096/ # 200 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8096/no-such-route # 404 (Symfony router) curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9097/health # 200

参见

发现错误？报告问题 →