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 днів або ключ з листа після оплати.