Laravel на OxPHP

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

docker-compose.yml

services:
  app:
    build:
      context: ./src
      target: dev
    image: laravel-oxphp/app:dev
    container_name: laravel-oxphp
    ports:
      - "8091:80"
      - "9092:9090"
    volumes:
      - ./src:/var/www/html          # live-edit without rebuilding
    environment:
      # LISTEN_ADDR (0.0.0.0:80) and DOCUMENT_ROOT (/var/www/html/public) are
      # the OxPHP defaults, so both are omitted.
      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:9
    container_name: laravel-oxphp-db
    ports:
      - "3308:3306"
    environment:
      MYSQL_DATABASE: laravel
      MYSQL_USER: laravel
      MYSQL_PASSWORD: laravel
      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: 20
      start_period: 15s
    restart: unless-stopped

volumes:
  db_data:

Установка и первый запуск

Образ 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 выбирает фреймворковый режим. public/ из Laravel становится DOCUMENT_ROOT; собственные .env, app/, vendor/ фреймворка остаются вне корня документов и недоступны по HTTP.
Окружение контейнера переопределяет .env. OxPHP передаёт окружение контейнера в PHP, а dotenv-загрузчик Laravel не переопределяет реальные переменные окружения — поэтому DB_HOST, APP_ENV и прочие, заданные в Compose, побеждают.
OPcache перепроверяет файлы на каждый запрос в цели dev, поэтому правки в примонтированном 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

Смотрите также

Роутинг · Руководство по Docker · Справочник по конфигурации
Symfony и Yii3 — другие рецепты для фреймворкового режима