Yii3 на OxPHP

Yii3 — найлегший рецепт у цьому розділі. Шаблон yiisoft/app має фронт-контролер public/index.php, не потребує бази даних і, оскільки більшість роботи з рядками покрита поліфілами, майже не вимагає додаткових розширень PHP. Він природно лягає на режим маршрутизації фреймворку OxPHP і працює як один сервіс.

Стек коротко

Образ OxPHP: ghcr.io/oxphp/oxphp:0.13.0 (PHP 8.5)
Режим маршрутизації: фреймворк (ENTRY_FILE=index.php; DOCUMENT_ROOT лишається типовим — /var/www/html/public)
Додані розширення: mbstring (нативне, заради швидкодії — інакше середовище виконання підмінює його поліфілом)
Сервіси: лише 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"]

docker-compose.yml

services:
  app:
    build:
      context: ./src
      target: dev
    image: yii3-oxphp/app:dev
    container_name: yii3-oxphp
    ports:
      - "8094:80"
      - "9095:9090"
    volumes:
      - ./src:/var/www/html
    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
    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

Note

Шаблон yiisoft/app постачається з власним .dockerignore у стилі білого списку — залиште його. Коли src/ змонтовано як bind mount, 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

Промпти для вашого агента

Ці промпти розраховані на агента з підключеним MCP-сервером документації OxPHP — потрібні сторінки він прочитає сам.

prompt

Запусти мій застосунок Yii3 на OxPHP локально. Прочитай сторінку `examples/framework/yii3` через MCP-сервер документації OxPHP.
Напиши Dockerfile і Compose-файл для цього репозиторію — рецепт описує один сервіс без бази даних, тож додай ті сервіси, які насправді підключає мій `config/`, — і дай мені команди для першого запуску.

prompt

Мій застосунок Yii3 працює на OxPHP, але опубліковані ресурси повертають 404. Прочитай сторінку `examples/framework/yii3` через MCP-сервер документації OxPHP.
Звір мої asset bundles і білий список `.dockerignore` із шаблону з кореневим каталогом документів, який задає мій Compose-файл, і скажи, хто з них губить файли.

Див. також

Маршрутизація · Посібник із Docker
Laravel і Symfony — інші рецепти для режиму фреймворку