在 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 将 OxPHP 拷贝进一个 php:8.5-zts-alpine 基础镜像，该镜像已带有 Laravel 的运行时扩展。

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"]

安装与首次运行

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 目标下每个请求都重新校验，所以对 bind 挂载的 src/ 所做的编辑会立即生效。生产环境下请设置 opcache.validate_timestamps=0 并去掉 bind 挂载。

验证

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

参见

发现错误？报告问题 →