GitHub

October CMS на OxPHP

October CMS (на основі Laravel) постачається з index.php у корені проєкту, поруч із config/, .env і vendor/. Її конфігурація nginx перенаправляє все на index.php і віддає статичні файли лише з дозволених шляхів ресурсів (*/assets). Щоб відтворити такий самий підхід в OxPHP, не відкриваючи вихідні файли тем і конфігурацію, цей рецепт створює кореневий каталог документів public/ за допомогою php artisan october:mirror public і спрямовує на нього режим фреймворку.

Саме в цьому рецепті задіяно параметр OxPHP SYMLINK_ALLOW_PATHS.

Стек коротко

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

october/october встановлюється безпосередньо з Packagist. Стек компонентів Laravel 11 старший за PHP 8.5, тому тут зафіксовано образ PHP 8.4.

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

bash
mkdir -p october-oxphp/src docker run --rm -e COMPOSER_ALLOW_SUPERUSER=1 \ -v "$PWD/october-oxphp/src":/app -w /app \ composer:2 create-project october/october . --no-interaction --prefer-dist

Потім вкажіть у src/.env сервіс бази даних (DB_HOST=db, DB_DATABASE=october, …) і задайте APP_URL=http://localhost:8098.

Dockerfile і Compose-файл

Dockerfile названо src/Dockerfile.oxphp, щоб він не конфліктував із власними ресурсами October.

src/Dockerfile.oxphp
ARG OXPHP_VERSION=0.13.0 ARG PHP_VERSION=8.4 ARG ALPINE_VERSION=3.23 # ── PHP base: October 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 mbstring zip \ && 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 ──────────────────── 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/october.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 EXPOSE 80 9090 CMD ["oxphp"]

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

October CMS 4 не має майстра встановлення october:install і не створює адміністратора за замовчуванням, тому послідовність така: міграції → таблиці контенту → дзеркало → створення адміністратора:

bash
docker compose up -d db # 1. Schema and module seeds docker compose run --rm app php artisan october:migrate # 2. Dynamic content tables (the demo theme uses Tailor content) docker compose run --rm app php artisan tailor:migrate # 3. Build the public/ document root (index.php + */assets symlinks) docker compose run --rm app sh -c 'mkdir -p public && php artisan october:mirror public --relative' # 4. Create a backend super-user (no install wizard exists) docker compose run --rm app php artisan tinker --execute ' $u = Backend\Models\User::firstOrNew(["login" => "admin"]); $u->email = "admin@example.com"; $u->password = "admin123"; $u->password_confirmation = "admin123"; $u->is_superuser = true; $u->is_activated = true; $u->save();' docker compose up -d app

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

Note
  • october:mirror public відтворює білий список ресурсів із конфігурації nginx для October. Команда створює каталог public/, у якому є лише index.php (символьне посилання) і символьні посилання на каталоги */assets, — сторінки тем .htm, config/, .env, vendor/ і storage/logs лишаються поза кореневим каталогом документів. За DOCUMENT_ROOT=…/public жоден із них не доступний через HTTP.
  • SYMLINK_ALLOW_PATHS=/var/www/html обовʼязковий. За замовчуванням OxPHP блокує символьні посилання, що ведуть за межі DOCUMENT_ROOT. Посилання дзеркала вказують назад у дерево проєкту (/var/www/html/modules/…, /var/www/html/themes/…), тому корінь проєкту додано до білого списку. /var заблоковано за точним збігом, але не за префіксом, тож /var/www/html дозволено. Див. Дозволені шляхи для символьних посилань.
  • Про tailor:migrate легко забути. Без нього демо-тема видає SQLSTATE 1146: table 'xc_…' doesn't exist, бо її колекції контенту — це схеми Tailor, таблиці яких створюються окремо від october:migrate.

Перевірка

bash
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8098/ # 200 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8098/admin # 302 → login curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8098/themes/demo/assets/css/theme.css # 200 # the document-root mirror keeps internals out: curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8098/.env # 404 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8098/themes/demo/pages/home.htm # 404

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

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

prompt
Запусти мій проєкт на October CMS в OxPHP локально. Прочитай сторінку `examples/cms/october` через MCP-сервер документації OxPHP. Напиши Dockerfile і Compose-файл для цього репозиторію, а потім дай мені послідовність встановлення по порядку: міграції разом із Tailor, збирання дзеркала `public/` з моїх тем і плагінів та створення користувача адмінпанелі.
prompt
Мій сайт на October CMS в OxPHP віддає сторінки, але ресурси тем і плагінів повертають 404. Прочитай сторінку `examples/cms/october` через MCP-сервер документації OxPHP. Звір моє дзеркало `public/` з каталогами `*/assets`, які насправді постачають мої теми й плагіни, а також із `SYMLINK_ALLOW_PATHS` у моєму Compose-файлі, і скажи, що з цих двох налаштовано неправильно.

Дивіться також

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