GitHub

OpenCart на OxPHP

OpenCart — застосунок традиційного режиму з двома фізичними фронт-контролерами: index.php (вітрина) і admin/index.php (адмін-панель), а також статичними ресурсами в image/ і catalog/view/. Його вебкорінь — це сам корінь проєкту. Традиційний режим маршрутизації OxPHP — типовий, коли ENTRY_FILE не задано, — обслуговує обидві точки входу як справжні файли, а статичні ресурси віддає з диска; PHP_DENY_PATHS блокує пряме виконання внутрішніх файлів фреймворку.

Стек коротко

  • Образ OxPHP: ghcr.io/oxphp/oxphp:0.13.0-php8.4-alpine3.23 (PHP 8.4)
  • Режим маршрутизації: традиційний (без ENTRY_FILE; DOCUMENT_ROOT = корінь проєкту, перевизначає типовий …/public)
  • Додані розширення: gd, mysqli, zip, mbstring
  • Сервіси: OxPHP + MySQL
  • URL: http://localhost:8095 · адмінка /admin/ · внутрішній http://localhost:9096/health
Версія PHP

OpenCart 4 потребує PHP 8.0+, але його кодова база старша за 8.5, тож закріпіть образ із PHP 8.4. OpenCart використовує драйвер mysqli, а не PDO. (Зауважте: OpenCart 3.x не працює на PHP 8.4+ — використовуйте OpenCart 4.x.)

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

OpenCart постачається як архів релізу, а не як пакет Composer. Вебкорінь — це вміст каталогу upload/ з архіву:

bash
mkdir -p opencart-oxphp/src curl -sL https://github.com/opencart/opencart/releases/download/4.1.0.3/opencart-4.1.0.3.zip -o /tmp/oc.zip unzip -q /tmp/oc.zip -d /tmp/oc cp -a /tmp/oc/upload/. opencart-oxphp/src/ # the installer needs these to exist and be writable: : > opencart-oxphp/src/config.php : > opencart-oxphp/src/admin/config.php

Dockerfile і Compose

Dockerfile називається src/Dockerfile.oxphp, щоб не конфліктувати з Dockerfile, який постачається разом з OpenCart.

src/Dockerfile.oxphp
ARG OXPHP_VERSION=0.13.0 ARG PHP_VERSION=8.4 ARG ALPINE_VERSION=3.23 # ── PHP base: OpenCart 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 mysqli 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 ──────────────────── 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=300"; \ } > /usr/local/etc/php/conf.d/opencart.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 && 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"]

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

OpenCart 4 постачається з інсталятором для CLI:

bash
docker compose up -d db docker compose run --rm app php install/cli_install.php install \ --username admin --password 'admin123' --email admin@example.com \ --http_server 'http://localhost:8095/' --language en-gb \ --db_driver mysqli --db_hostname db --db_username opencart \ --db_password opencart --db_database opencart --db_port 3306 --db_prefix oc_ # OpenCart recommends removing the installer afterwards: rm -rf opencart-oxphp/src/install docker compose up -d app

Нотатки щодо OxPHP

Note
  • Традиційний режим обслуговує два фронт-контролери. index.php (вітрина) і admin/index.php (адмінка) — обидва фізичні точки входу; традиційний режим виконує кожен як справжній файл. Режим фреймворку спрямовував би все до одного index.php і зламав би адмінку.
  • PHP_DENY_PATHS захищає внутрішні файли. Коли вебкорінь збігається з коренем проєкту, system/ і install/ лежать усередині DOCUMENT_ROOT. PHP_DENY_PATHS=/system/**,/install/** блокує пряме виконання цих скриптів через HTTP — зіставлення відбувається до звернення до диска, тож оракула існування файлів немає. Інсталятор для CLI запускається з оболонки, і це правило на нього не впливає. Див. Список заборони виконання PHP.
  • Файли з крапкою вже захищені. Шляхи на кшталт .env і шляхи з сегментами, що починаються з крапки, повертають 404 завдяки блокуванню шляхів із крапкою; окреме правило не потрібне.
  • SEO URL типово вимкнені. Типовий OpenCart використовує маршрутизацію через рядок запиту index.php?route=…, яку традиційний режим обробляє напряму без правил переписування.

Перевірка

bash
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8095/ # 200 storefront curl -s -o /dev/null -w "%{http_code}\n" "http://localhost:8095/index.php?route=common/home" # 200 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8095/admin/ # 200 admin login curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8095/system/startup.php # 404 (denied) curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9096/health # 200

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

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

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

Див. також

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