GitHub

Craft CMS на OxPHP

Craft CMS використовує web/index.php як фронт-контролер і віддає ресурси панелі керування з web/cpresources/. Він працює в режимі фреймворкової маршрутизації OxPHP: наявні статичні файли, зокрема ресурси панелі керування, віддаються з диска, а все інше передається до index.php.

Стек коротко

  • Образ OxPHP: ghcr.io/oxphp/oxphp:0.13.0 (PHP 8.5)
  • Режим маршрутизації: фреймворковий (ENTRY_FILE=index.php; DOCUMENT_ROOT=/var/www/html/web замінює типовий …/public)
  • Додані розширення: bcmath, gd, intl, pdo_mysql, mbstring, zip
  • Сервіси: OxPHP + MySQL (8.4 LTS)
  • URL: http://localhost:8092 · панель керування /admin · внутрішній http://localhost:9093/health

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

bash
mkdir -p craft-oxphp/src docker run --rm -v "$PWD/craft-oxphp/src":/app -w /app \ composer:2 create-project craftcms/craft . \ --ignore-platform-reqs --no-scripts --no-interaction --prefer-dist
Note

--ignore-platform-reqs --no-scripts потрібні, бо в стандартному образі composer:2 немає bcmath/gd/intl; вони знадобляться лише під час виконання, а майстер налаштування Craft, що запускається після створення проєкту, відпрацює пізніше — усередині зібраного контейнера.

Craft бере параметри підключення до бази даних зі змінних оточення, тож редагувати .env не потрібно — окрім ключів, які записує консоль.

Dockerfile і Compose

Нижче наведено обидва файли; Dockerfile розташований у src/Dockerfile.

src/Dockerfile
ARG OXPHP_VERSION=0.13.0 ARG PHP_VERSION=8.5 ARG ALPINE_VERSION=3.23 # ── PHP base: Craft runtime extensions ──────────────────────── FROM php:${PHP_VERSION}-zts-alpine${ALPINE_VERSION} AS php-base RUN apk add --no-cache \ icu-libs libpng libjpeg-turbo freetype oniguruma libzip \ && apk add --no-cache --virtual .build-deps \ icu-dev 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)" bcmath gd intl pdo_mysql mbstring zip \ && 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 + Craft extensions ── 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 { \ echo "memory_limit=256M"; echo "upload_max_filesize=64M"; \ echo "post_max_size=64M"; echo "max_execution_time=120"; \ } > /usr/local/etc/php/conf.d/craft.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 COPY --chown=www-data:www-data . /var/www/html EXPOSE 80 9090 CMD ["oxphp"]

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

Craft встановлюється через власну консоль, яка працює в тому самому контейнері:

bash
docker compose up -d --build docker compose exec app php craft setup/security-key # writes CRAFT_SECURITY_KEY docker compose exec app php craft setup/app-id # writes CRAFT_APP_ID docker compose exec app php craft install/craft \ --username=admin --email=admin@example.com --password=password \ --site-name="Craft OxPHP" --site-url='http://localhost:8092' --language=en-US

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

Note
  • Ресурси панелі керування — це статичні файли. web/cpresources/<hash>/… лежить на диску й віддається фреймворковим режимом — переконайтеся, що він повертає 200, інакше панель керування відобразиться без стилів.
  • Використовуйте MySQL 8.4 LTS, а не MySQL 9. Craft перевірено з MySQL 8.x; образ 8.4 LTS — безпечний вибір. (У MySQL 8.4 прибрали серверний прапорець --default-authentication-plugin — не передавайте його.)
  • Налаштування бази даних беруться з оточення контейнера (CRAFT_DB_*), тому вони задаються в Compose.

Перевірка

bash
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8092/ # 200 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8092/admin # 302 → login curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9093/health # 200

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

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

prompt
Запусти мій проєкт на Craft CMS локально на OxPHP. Прочитай сторінку `examples/cms/craft` через MCP-сервер документації OxPHP. Напиши Dockerfile і Compose-файл для цього репозиторію з розширеннями, які потрібні моїм встановленим плагінам понад власні розширення Craft, і дай мені послідовність консольних команд, що встановлює його на чисту базу даних.
prompt
Встановлення Craft на OxPHP у мене падає на базі даних — підключення не встановлюється або MySQL не запускається. Прочитай сторінку `examples/cms/craft` через MCP-сервер документації OxPHP. Звір тег образу MySQL і серверні прапорці в моєму Compose-файлі та мої змінні `CRAFT_DB_*` з тим, що досі задає мій `.env`, і скажи, які з них Craft насправді читає.

Див. також

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