PHP Upgrade Check для OpenCart — что сломается после перехода на PHP 8.3, 8.4 или 8.5

PHP Upgrade Check для OpenCart — модуль от студии CatCode, который отвечает на один вопрос перед сменой версии PHP: что в этом магазине перестанет работать? PHP 8.1 не получает исправлений безопасности после 31.12.2025, PHP 8.2 будет получать их только до 31.12.2026 (даты php.net), а магазин за годы оброс модулями разных авторов, патчами OCMOD и vQmod, темой с правками. Переключить PHP «на пробу» на рабочем магазине — значит рисковать страницей ошибки вместо товара или оформления.

Модуль читает каждый PHP-файл магазина — ядро OpenCart, расширения, код патчей OCMOD и vQmod, темы, библиотеки — и сравнивает с тем, что PHP 7.0 … 8.5 убрал или изменил, по официальным руководствам по миграции php.net. Для выбранной версии PHP каждое расширение, патч и тема получают вывод, а каждая находка — файл, строку, код и способ исправления. Ничего не выполняется и ничего не меняется.

Как это выглядит для покупателя

Покупатель модуль не видит: на витрине нет ни его кода, ни события, ни патча. Его работа — чтобы покупатель не увидел другого: страницы ошибки вместо товара, пустой страницы или оформления, которое остановилось на шаге оплаты, после того как хостинг переключил PHP.

После смены версии PHP магазин ломается по-разному. Функцию, которую PHP убрал (each(), create_function(), mysql_*), PHP не найдёт — и страница остановится с фатальной ошибкой. Устаревшая функция в OpenCart 4.0 – 4.1.0.3 с выключенным показом ошибок перебрасывает посетителя на страницу ошибки. Часть функций работает, но даёт другой результат. Модуль находит эти места до переключения, так что вы исправляете их по своему расписанию, а не после жалоб покупателей.

Что получает админ

Пункт Система → PHP Upgrade Check с четырьмя вкладками: «Обзор», «Отчёт», «Журнал ошибок» (Pro) и «Настройки». Пункт появляется сразу после установки.

Обзор

• Этот сервер сейчас: версия PHP и статус её поддержки по датам php.net, кнопка «Проверить новейший выпуск на php.net», версия OpenCart и минимальный PHP, который она требует (из system/startup.php), база данных, ionCube Loader, расширения PHP, нужные OpenCart, memory_limit и max_execution_time.
• Что этот OpenCart делает с «Deprecated»: модуль читает обработчик ошибок вашего магазина и пишет простыми словами, попадёт ли устаревшая функция только в журнал или перебросит посетителя на страницу ошибки.
• Проверка: выбор версии PHP (7.4 – 8.5), кнопка «Проверить сейчас» с прогрессом и остановкой, дата последней проверки, количество файлов и файлы, которые не удалось прочитать.
• Результат: сколько расширений и частей магазина сломается, потребует расширения PHP, даст другой результат, закодировано, имеет только предупреждения и готово; отдельно — файлы ядра; список «Что исправлять в первую очередь».

Отчёт

Таблица «что — вывод — найдено» по каждому расширению, патчу, теме и части ядра. «Подробнее» раскрывает находки: уровень, файл и строку, сам код, что изменилось и в какой версии PHP, как исправить, и блок «Что делать» — попросить у автора версию для нужного PHP или поручить разработчику исправить строки. Версия PHP переключается кнопками без новой проверки; переключатели «Показать готовые», «Показать неустановленные» и «Показать библиотеки» добавляют то, что по умолчанию скрыто.

Патчи OCMOD и vQmod

У патча нет собственных файлов: его код вставляется в чужой файл. Модуль читает код каждой вставки OCMOD из базы и каждого XML vQmod и показывает находку с названием патча и строкой файла, который он меняет, — то есть вы сразу видите, какой модуль просить обновить.

Журнал ошибок (Pro)

Для того, что видно только во время работы. Переключите копию магазина (или сам магазин на тихий час) на новый PHP, пройдите витрину, корзину, оформление и админку — и вернитесь сюда: модуль читает error.log OpenCart и error_log PHP, группирует одинаковые сообщения, считает, сколько раз и когда последний, и привязывает каждое к расширению, патчу или ядру.

Настройки

• Целевой PHP по умолчанию (8.3), проверять или нет файлы ядра и библиотеки vendor/.
• Дополнительные папки, которые тоже нужно проверить, и пути, которые пропускать (например, старую копию в system/library).
• Лицензия: триал Pro на 7 дней или ключ после покупки.

Как это работает — шаг за шагом

1. Список файлов. admin/ (и переименованная админка), catalog/, system/ без кэша, журналов, сессий и загрузок, extension/ в OpenCart 4, PHP-файлы в корне, библиотеки vendor/ (в том числе вне корня магазина), vQmod, код патчей OCMOD из базы и ваши дополнительные папки.
2. Группы. Каждый файл кому-то принадлежит: расширению OpenCart 4 (название, версия и автор — из записей установщика или install.json), расширению из установщика OpenCart 3, ядру (по официальному списку файлов вашей линейки OpenCart), расширению, которое поставляется с OpenCart (установлено или нет), стороннему расширению, теме, библиотеке или «другим файлам».
3. Чтение. Каждый файл разбирается токенизатором PHP — тем же, которым PHP читает код, — без выполнения. Большие файлы модуль берёт с оглядкой на memory_limit сервера, а те, что не помещаются, перечисляет «проверьте вручную».
4. Правила. 92 функции, 6 расширений целиком (mysql, mssql, mcrypt, imap, pspell, oci8), 30 констант и правила синтаксиса и поведения из руководств по миграции php.net для 7.0 … 8.5: each() и create_function() (убраны в 8.0), $str{0} (8.0), strftime() (устарела в 8.1), «${var}» в строках (8.2), параметр «Type $x = null» без «?» (8.4), curl_close() и imagedestroy() (устарели в 8.5) и другие.
5. Без ложных тревог. Неустановленное расширение считается отдельно — его код не выполняется. Драйвер базы, который не использует config.php, молчит. Функцию, которую магазин объявляет сам (полифил), модуль не считает убранной. Строка за проверкой версии PHP (PHP_VERSION_ID, version_compare, function_exists) не считается там, где она не выполняется.
6. Вывод. Для выбранной версии PHP каждая находка получает уровень: сломается, остановит страницу, нужно расширение, изменится результат, не проверить, предупреждение. Вывод группы — худший уровень её находок. На OpenCart 4.0 – 4.1.0.3 с выключенным показом ошибок устаревшая функция считается как «Остановит страницу».
7. Дальше — вы. Переключаете версию PHP в отчёте без новой проверки, обновляете или исправляете расширения и запускаете проверку снова, пока вывод не станет «Готово».

Что проверено, а что нет

Проверено локально на четырёх версиях OpenCart из официальных архивов: 4.1.0.3 (mysqli), 4.0.2.3 (pdo), 3.0.5.0 и 2.3.0.2, на PHP 5.6, 7.0, 8.1, 8.3 и 8.5, с включённым и выключенным показом ошибок. Каждая страница и каждое действие модуля — без единого сообщения PHP в журнале. Выводы сверены с ожидаемыми на тестовых расширениях и настоящих модулях (Mollie 14.1.2, Mollie 9.4 с vQmod 2.6.6, d_quickcheckout). «Неудобные» файлы — без доступа, бинарные, с ошибкой синтаксиса, в кодировке cp1251, с BOM, с вложенностью на 3 000 уровней, петли символьных ссылок, файлы больше 768 КБ — проверка доходит до конца и перечисляет, что не прочитала. Большой магазин — 60 836 файлов за 180 секунд. Лицензионный сервер в тестах подменял тестовый.

Границы, о которых стоит знать. Проверка статическая: того, что проявляется только во время работы (null в строковой функции, неизвестный ключ массива, преобразование дробного в целое), она не видит — для этого Pro-страница «Журнал ошибок». Правило о свойствах, созданных на лету (PHP 8.2), проверяет только классы без родительского класса, __set() и трейтов, так что может пропустить часть случаев. Находки в библиотеках vendor/ важны, только если библиотекой что-то пользуется, поэтому по умолчанию они скрыты. Настоящие закодированные модули сторонних авторов мы не проверяли — только собственный закодированный тестовый файл. Не запускали вживую: OpenCart 4.0.0.x – 4.0.1.x и 4.1.0.4, 3.0.0 – 3.0.3.x (списки файлов ядра их покрывают), MySQL 5.7, пакеты OCMOD для OpenCart 4, хостинги без исходящих соединений (там кнопка php.net просто скажет, что он не ответил). Правила — до PHP 8.5 включительно; следующие версии PHP потребуют обновления модуля.

Что под капотом

• Только чтение. Файлы разбираются токенизатором PHP и никогда не подключаются и не выполняются; модуль не пишет ни в чьи файлы.
• Одно событие админки — пункт меню в «Система». Без событий витрины, без OCMOD и без правок ядра.
• Собственные таблицы для проверки, очереди, групп, находок и отметок; удаление модуля их убирает.
• Шаги через AJAX по 6 секунд с очередью в базе: проверка не упирается в max_execution_time и продолжается, пока не дойдёт до конца.
• Модуль сам не даёт сообщений PHP. На OpenCart 4 с выключенным показом ошибок даже одно предупреждение перебросило бы админку на страницу ошибки, поэтому все обращения к файлам — «тихие», а нечитаемый файл просто попадает в список.
• Списки файлов ядра — из тегов OpenCart на GitHub: 2.0.0.0 – 2.3.0.2, 3.0.0.0 – 3.0.5.1, 4.0.0.0 – 4.1.0.4.
• php.net: даты поддержки версий встроены в модуль; новейший выпуск — запрос только по кнопке, с кэшем на сутки.
• Лицензия — отдельной группой настроек, так что сохранение настроек её не затрагивает.

Как установить

1. OpenCart 4: Расширения → Установщик → загрузите cc_phpupgrade.ocmod.zip (имя архива не меняйте) и нажмите «Установить». OpenCart 3: Расширения → Установщик → cc_phpupgrade-oc3.ocmod.zip. OpenCart 2.3: скопируйте содержимое папки upload/ из архива cc_phpupgrade-oc2.ocmod.zip в корень магазина.
2. Расширения → Расширения → Модули → PHP Upgrade Check → «Установить».
3. Система → PHP Upgrade Check: выберите версию PHP, на которую переходите, и нажмите «Проверить сейчас».
4. Откройте «Полный отчёт» и начните со списка «Что исправлять в первую очередь».
5. Для Pro: Настройки → Лицензия — триал на 7 дней или ключ из письма после оплаты.