GitHub

WordPress на OxPHP

WordPress — це застосунок традиційного режиму. Він має багато фізичних точок входу (index.php, wp-login.php, wp-cron.php і весь каталог wp-admin/), і до кожної з них слід звертатися як до справжнього файлу. Традиційний режим маршрутизації OxPHP, який діє за замовчуванням, коли ENTRY_FILE не задано, обслуговує їх саме так. Не задавайте ENTRY_FILE: режим фреймворку спрямовував би кожен запит до одного фронт-контролера й зламав би wp-admin.

Цей рецепт також показує другий варіант збирання. Замість того щоб копіювати OxPHP у базовий образ PHP, він безпосередньо розширює образ середовища виконання OxPHP: розширення WordPress компілюються на окремому етапі збирання, а готові файли .so просто додаються в образ.

Стек коротко

  • Образ OxPHP: ghcr.io/oxphp/oxphp:0.13.0 (PHP 8.5), розширений на місці
  • Режим маршрутизації: традиційний (без ENTRY_FILE)
  • Додані розширення: mysqli, pdo_mysql, gd, zip, intl, exif, bcmath
  • Сервіси: OxPHP + MySQL + допоміжний контейнер WP-CLI (профіль cli)
  • Посилення захисту: PHP_DENY_PATHS блокує пряме виконання .php у wp-content/uploads/
  • URL: http://localhost:8090 · внутрішній http://localhost:9091/health

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

text
wp-oxphp/ ├── Dockerfile ├── docker-compose.yml └── wordpress/ # the WordPress tree (download from wordpress.org) └── wp-config.php # reads WORDPRESS_* environment variables

wordpress/wp-config.php зчитує свої налаштування із середовища контейнера:

wp-config.php
define( 'DB_NAME', getenv( 'WORDPRESS_DB_NAME' ) ?: 'wordpress' ); define( 'DB_USER', getenv( 'WORDPRESS_DB_USER' ) ?: 'wordpress' ); define( 'DB_PASSWORD', getenv( 'WORDPRESS_DB_PASSWORD' ) ?: 'wordpress' ); define( 'DB_HOST', getenv( 'WORDPRESS_DB_HOST' ) ?: 'db:3306' ); $__site_url = getenv( 'WORDPRESS_SITE_URL' ) ?: 'http://localhost:8090'; define( 'WP_HOME', $__site_url ); define( 'WP_SITEURL', $__site_url );

Dockerfile і Compose

Цей Dockerfile компілює розширення на відповідному образі php:8.5-zts-alpine (той самий ABI, що й в образі OxPHP, no-debug-zts-20250925) і копіює файли .so у середовище виконання OxPHP:

Dockerfile
# ── Stage 1: compile WordPress PHP extensions against PHP 8.5 ───── FROM php:8.5-zts-alpine3.23 AS ext-builder RUN apk add --no-cache \ icu-dev libzip-dev libpng-dev libjpeg-turbo-dev freetype-dev oniguruma-dev \ && docker-php-ext-configure gd --with-jpeg --with-freetype \ && docker-php-ext-install -j"$(nproc)" \ mysqli pdo_mysql gd zip intl exif bcmath RUN EXT_DIR=$(php -r 'echo ini_get("extension_dir");') && mkdir -p /ext-out \ && cp "$EXT_DIR"/mysqli.so "$EXT_DIR"/pdo_mysql.so "$EXT_DIR"/gd.so \ "$EXT_DIR"/zip.so "$EXT_DIR"/intl.so "$EXT_DIR"/exif.so \ "$EXT_DIR"/bcmath.so /ext-out/ # ── Stage 2: OxPHP runtime with WordPress extensions ───────────── FROM ghcr.io/oxphp/oxphp:0.13.0 AS runtime USER root RUN apk add --no-cache icu-libs libzip libpng libjpeg-turbo freetype oniguruma # Drop the compiled extensions into OxPHP's PHP 8.5 extension dir COPY --from=ext-builder /ext-out/*.so \ /usr/local/lib/php/extensions/no-debug-zts-20250925/ RUN { \ echo "extension=mysqli.so"; echo "extension=pdo_mysql.so"; \ echo "extension=gd.so"; echo "extension=zip.so"; \ echo "extension=intl.so"; echo "extension=exif.so"; \ echo "extension=bcmath.so"; \ } > /usr/local/etc/php/conf.d/wordpress-extensions.ini RUN { \ echo "upload_max_filesize=64M"; echo "post_max_size=64M"; \ echo "memory_limit=256M"; echo "max_execution_time=300"; \ echo "max_input_vars=3000"; \ } > /usr/local/etc/php/conf.d/wordpress.ini EXPOSE 80
Note

Каталог розширень (no-debug-zts-20250925) — це тег ABI для PHP 8.5 ZTS. Якщо ви збираєте на образі OxPHP з PHP 8.4, він стає no-debug-zts-20240924. Визначайте його під час збирання за допомогою php -r 'echo ini_get("extension_dir");', а не прописуйте жорстко.

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

bash
docker compose up -d --build docker compose run --rm wpcli wp core install \ --url=http://localhost:8090 --title="OxPHP WordPress" \ --admin_user=admin --admin_password=admin --admin_email=admin@example.com

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

Note
  • Традиційний режим обовʼязковий. WordPress потребує, щоб wp-admin/, wp-login.php, wp-cron.php тощо виконувалися як фізичні файли. Не задавайте ENTRY_FILE.
  • Образ середовища виконання OxPHP не містить бінарного файлу wp (це мінімальний образ для обслуговування запитів). Робота з CLI виконується через допоміжний контейнер wpcli у профілі Compose cli, який використовує той самий том wordpress/ і ту саму базу даних.
  • wp-config.php зчитує середовище контейнера через getenv(), тож облікові дані бази даних і URL сайту задаються в Compose, а не прописуються у файлі.
  • PHP_DENY_PATHS посилює захист каталогів завантажень. Оскільки традиційний режим виконує фізичні файли .php, вебшел, завантажений у wp-content/uploads/ через вразливий плагін, інакше було б виконано. PHP_DENY_PATHS блокує виконання .php у цих шляхах, зіставляючи їх з URI до будь-якого дискового введення-виведення, тож не виникає оракула існування файлів. Це діє лише в традиційному режимі та режимі SPA; у режимі фреймворку параметр нічого не робить (фронт-контролер і так запобігає прямому виконанню .php), тому рецептам для режиму фреймворку тут він не потрібен. Див. Список заборони виконання PHP.

Перевірка

bash
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8090/ # 200 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8090/wp-login.php # 200 (physical file) curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8090/wp-content/uploads/x.php # 404 (PHP_DENY_PATHS) curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9091/health # 200

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

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

prompt
Запусти мій сайт на WordPress в OxPHP локально. Прочитай сторінку `examples/cms/wordpress` через MCP-сервер документації OxPHP. Напиши Dockerfile і файл Compose для цього дерева — традиційний режим, допоміжний контейнер WP-CLI та розширення, яких справді потребують мої активні плагіни й тема, — і налаштуй `wp-config.php` так, щоб він зчитував облікові дані із середовища контейнера.
prompt
Після переходу на OxPHP частина мого сайту на WordPress віддає 404 — сторінка адмінки або ендпоінт плагіна. Прочитай сторінку `examples/cms/wordpress` через MCP-сервер документації OxPHP. Звір мої glob-шаблони `PHP_DENY_PATHS` і те, чи задано `ENTRY_FILE`, з ендпоінтами `.php`, які надають мої встановлені плагіни, і скажи, котрий із них перехоплює запит.

Див. також

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