GitHub

Drupal на OxPHP

Drupal 11 використовує web/index.php як фронт-контролер із чистими URL — кожен шлях, що не веде до файлу, переписується на index.php, а це саме те, що робить режим маршрутизації фреймворку в OxPHP. Агреговані CSS/JS потрапляють до web/sites/default/files/ і віддаються з диска, як будь-який інший статичний ресурс.

Стек коротко

  • Образ OxPHP: ghcr.io/oxphp/oxphp:0.13.0-php8.4-alpine3.23 (PHP 8.4)
  • Режим маршрутизації: фреймворк (ENTRY_FILE=index.php; DOCUMENT_ROOT=/var/www/html/web замінює типовий …/public)
  • Додані розширення: gd, pdo_mysql, zip, mbstring
  • Сервіси: OxPHP + MySQL
  • URL: http://localhost:8097 · внутрішній http://localhost:9098/health
Версія PHP

Drupal 11 потребує PHP 8.3+ і офіційно підтримує 8.4. Його стек компонентів Symfony старший за PHP 8.5, тому цей рецепт фіксує образ OxPHP з PHP 8.4. Drupal використовує PDO (pdo_mysql), а не mysqli.

Структура проєкту

bash
mkdir -p drupal-oxphp/src docker run --rm -e COMPOSER_ALLOW_SUPERUSER=1 \ -v "$PWD/drupal-oxphp/src":/app -w /app \ composer:2 create-project drupal/recommended-project . \ --ignore-platform-reqs --no-interaction --prefer-dist docker run --rm -e COMPOSER_ALLOW_SUPERUSER=1 \ -v "$PWD/drupal-oxphp/src":/app -w /app \ composer:2 require drush/drush --ignore-platform-reqs --no-interaction
Note

--ignore-platform-reqs потрібен, бо стандартний образ composer:2 не має gd; це розширення знадобиться лише під час виконання, а там його надає образ OxPHP.

Dockerfile і Compose

src/Dockerfile
ARG OXPHP_VERSION=0.13.0 ARG PHP_VERSION=8.4 ARG ALPINE_VERSION=3.23 # ── PHP base: Drupal runtime extensions ─────────────────────── FROM php:${PHP_VERSION}-zts-alpine${ALPINE_VERSION} AS php-base RUN apk add --no-cache \ libpng libjpeg-turbo freetype oniguruma libzip \ && apk add --no-cache --virtual .build-deps \ libpng-dev libjpeg-turbo-dev freetype-dev oniguruma-dev libzip-dev \ && docker-php-ext-configure gd --with-jpeg --with-freetype \ && docker-php-ext-install -j"$(nproc)" gd pdo_mysql zip mbstring \ && apk del .build-deps # ── Composer ────────────────────────────────────────────────── FROM composer:2 AS composer # ── OxPHP artifacts (PHP 8.4 image) ─────────────────────────── FROM ghcr.io/oxphp/oxphp:${OXPHP_VERSION}-php${PHP_VERSION}-alpine${ALPINE_VERSION} AS oxphp # ── dev: OxPHP server + PHP CLI + Composer + drush ──────────── 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 { \ echo "memory_limit=256M"; echo "upload_max_filesize=64M"; \ echo "post_max_size=64M"; echo "max_execution_time=300"; \ } > /usr/local/etc/php/conf.d/drupal.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/web && chown -R www-data:www-data /var/www/html ENV LD_LIBRARY_PATH=/usr/local/lib WORKDIR /var/www/html EXPOSE 80 9090 CMD ["oxphp"]

Встановлення та перший запуск

drush — найзручніший неінтерактивний інсталятор:

bash
docker compose up -d --build docker compose exec app vendor/bin/drush site:install standard \ --db-url=mysql://drupal:drupal@db:3306/drupal \ --account-name=admin --account-pass=admin123 \ --site-name="Drupal OxPHP" -y

Примітки щодо OxPHP

Note
  • Чисті URL — це режим фреймворку. Пара RewriteCond !-f + RewriteRule ^ index.php у Drupal робить точнісінько те саме, що й режим фреймворку: віддає наявні файли, а все інше передає до web/index.php.
  • Агреговані ресурси віддаються з диска. Drupal записує об’єднані CSS/JS до web/sites/default/files/css і …/js; OxPHP віддає їх як статичні файли.
  • Перший запит повільний, далі — швидко. Холодний перший запит прогріває компіляцію Twig, агрегацію ресурсів і кеші (≈15 с). Наступні запити тривають одиниці мілісекунд. Це прогрів самого Drupal, а не накладні витрати OxPHP.

Перевірка

bash
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8097/ # 200 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8097/user/login # 200 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9098/health # 200

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

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

prompt
Запусти мій сайт на Drupal на OxPHP локально. Прочитай сторінку `examples/cms/drupal` через MCP-сервер документації OxPHP. Напиши Dockerfile і Compose-файл для цього репозиторію, зафіксувавши ту версію PHP, яку справді дозволяють мої contrib-модулі, і дай мені послідовність команд drush, що встановлює сайт на чисту базу даних.
prompt
Мій сайт на Drupal на OxPHP відкривається без стилів або одразу віддає 404. Прочитай сторінку `examples/cms/drupal` через MCP-сервер документації OxPHP. Порівняй `DOCUMENT_ROOT` у моєму Compose-файлі з вебкоренем, який створює мій `composer.json`, і з місцем, куди записуються мої агреговані CSS і JS, і скажи, що з цього не збігається.

Див. також

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