GitHub

Laravel на OxPHP

Laravel — зразковий застосунок для фреймворкового режиму: єдиний фронт-контролер у public/index.php, а статичні ресурси віддаються безпосередньо з public/. Фреймворковий режим маршрутизації OxPHP точно лягає на цю схему. Наявні файли віддаються з диска; усе інше передається до index.php.

Стек коротко

  • Образ OxPHP: ghcr.io/oxphp/oxphp:0.13.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.13.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 вмикає фреймворковий режим. 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

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

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

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

Див. також

Знайшли помилку? Повідомте →