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

PHP Upgrade Check для WooCommerce проверяет плагины и темы магазина перед переходом на более новую версию PHP и показывает, что именно сломается: плагин, файл, строку, сам код и как его исправить. Вы выбираете версию, на которую переходите, — 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 или 8.5, — а плагин сверяет код со всем, что PHP убрал или изменил с 7.0 по 8.5. Проверка работает на том PHP, что стоит сейчас (от 7.2), поэтому результат виден до того, как хостинг что-то переключит.

Хостинги переводят сайты со старых версий PHP: PHP 7.4 не получает исправлений безопасности с ноября 2022 года, PHP 8.1 — с конца 2025-го, а PHP 8.2 перестанет их получать 31 декабря 2026 года. Для магазина на WooCommerce вопрос всегда один: будет ли работать оформление заказа после переключения. Достаточно одного старого плагина с удалённой функцией — и вместо страницы покупатель увидит фатальную ошибку.

Как считается вердикт. В вердикт идёт только то, что изменится между версией PHP, на которой сайт работает сегодня, и целевой. Код, который падал бы уже на текущем PHP, — например, функции mysql_*, убранные в PHP 7.0, на сервере с PHP 8.3, — либо никогда не выполняется, либо уже сломан, и переход на новую версию его не изменит. Такие находки видны во вкладке «Находки» с пометкой «в вердикте не учитывается», но плагин из-за них не получает «Сломается». Закодированные файлы и заголовок Requires PHP, превышающий целевую версию, учитываются всегда.

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

Магазин на OpenCart? Для OpenCart 4, 3 и 2.3 есть отдельный модуль — PHP Upgrade Check для OpenCart.

Что увидит покупатель

Ничего. Плагин работает только в админке: страницы магазина не меняет и на витрине ничего не показывает. Проверка идёт короткими шагами по несколько секунд во вкладке администратора, а сайт в это время работает как обычно.

Журнал работы в Pro собирает сообщения PHP во время обычных запросов сайта, но посетителям их не показывает и не меняет того, как PHP и другие плагины (например, Query Monitor) обрабатывают ошибки: каждое сообщение передаётся дальше, как и без плагина. За один запрос записывается не больше 50 разных сообщений, в журнале — до 2 000 строк за последние 60 дней.

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

• Обзор сервера — версия PHP и до какого времени она получает исправления безопасности (данные php.net), есть ли более новый патч-релиз вашей ветки (с пометкой, что дистрибутивы Linux иногда переносят исправления без смены номера), поддерживает ли ваша версия WordPress целевой PHP, какой PHP нужен WooCommerce, стоит ли ionCube Loader и какие расширения PHP исчезнут в новой версии.
• Отчёт для выбранной версии PHP — счётчики «Сломается», «Закодировано — спросите разработчика», «Работает иначе», «Предупреждения об устаревшем», «Готово» и строка на каждый плагин и тему, must-use плагины и drop-in. Целевая версия переключается без новой проверки.
• Что делать — в строке плагина: «Сначала обновите до 6.2.3, затем проверьте снова», если новая версия плагина сама поддерживает целевой PHP; «Часть кода уже не работает на PHP 8.3 — этот код либо никогда не вызывается, либо уже сломан»; пометки «расширение WooCommerce» и «Нужен PHP 7.4» из заголовка плагина.
• «Проверить снова» для одного плагина или темы — после обновления не нужно проверять весь сайт.

• «Сломается» — код, который перестанет работать на целевом PHP: файл не загрузится из-за синтаксиса, которого PHP больше не понимает, или вызов закончится фатальной ошибкой. Сюда же — плагин, у которого в заголовке Requires PHP выше целевой версии.
• «Работает иначе» — код выполнится, но поведёт себя не так, как раньше: например, конструктор в стиле PHP 4, который с PHP 8.0 больше не вызывается при создании объекта.
• «Предупреждения об устаревшем» — плагин работает, но PHP выдаёт предупреждения: они засоряют журнал ошибок и в следующих версиях станут ошибками.

• Находки — для каждой: уровень и версия PHP, с которой это изменилось, что именно не так и как исправить, ссылка на php.net, плагин, файл, строка и сам код. Фильтр по плагину и уровню.
• Защищённый код — строки внутри проверки версии PHP, function_exists(), extension_loaded() или defined(), а также собственные замены удалённых функций в том же плагине помечаются «защищено» и в вердикт не идут. Их видно, если выбрать в фильтре.
• CSV — все находки одним файлом для разработчика, поддержки хостинга или автора плагина: запятая или точка с запятой, с BOM и защитой от формул, открывается в Excel и Google Таблицах.
• WP-CLI: wp catcode-php-check scan, wp catcode-php-check report --target=8.4 --format=json, wp catcode-php-check export report.csv.

• «Здоровье сайта» — тест, который говорит, сколько активных плагинов и тем сломается на целевом PHP. Он критический, когда текущий PHP уже не получает исправлений безопасности, и рекомендательный — когда ещё получает.

• Pro: журнал работы — предупреждения об устаревшем и фатальные ошибки PHP во время работы сайта, сгруппированные по плагину и теме, с файлом, строкой, количеством повторов, датой и версией PHP. Включите его перед переключением PHP и посмотрите после: он ловит то, чего не видно в коде.
• Pro: проверка после обновлений — плагин или тему, которые обновил WordPress, плагин проверяет снова в фоне, и отчёт показывает их новый вердикт.
• Pro: еженедельный отчёт — проверка в фоне раз в неделю и письмо с результатом на указанный адрес или администратору сайта.

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

1. Инструменты → PHP Upgrade Check. Плагин сразу показывает, на каком PHP работает сайт и до какого времени эта версия получает исправления безопасности.
2. В «Переходим на PHP» оставляете рекомендованную версию (для сайтов на PHP старше 8.3 — 8.3, дальше — следующая ветка) или выбираете свою и нажимаете «Запустить проверку».
3. Плагин составляет список кода: активные плагины, тема (дочерняя и родительская), must-use плагины, drop-in; по желанию — неактивные. Папки tests пропускаются, потому что на рабочем сайте не выполняются.
4. Каждый PHP-файл читается токенайзером PHP и сверяется с правилами: удалённые функции, расширения и константы, синтаксис, который больше не загружается, изменённое поведение, устаревшее в PHP 8.0–8.5. Ничего не выполняется. Проверка идёт шагами по несколько секунд; закрыли вкладку — «Продолжить проверку» досчитает с того же места.
5. Отчёт: вердикт на каждый плагин и тему, «Подробнее» — находки с исправлениями, CSV для разработчика. Другая целевая версия — в том же отчёте, без новой проверки.
6. Дальше — по подсказке на экране плагина: полная резервная копия, обновление плагинов и проверка снова, вопрос авторам того, что «Сломается» или «Закодировано», пробное переключение на копии сайта, потом — в панели хостинга в спокойное время и сразу проверка главной, товара, корзины и оформления заказа. Если что-то сломалось, PHP возвращается в панели обратно — файлы и база остаются как были.

Тестовый магазин с 76 плагинами (вместе с неактивными), темами, must-use плагинами и drop-in — 40 731 файл — плагин проверил за 53 секунды двенадцатью шагами, память — до 94 МБ, ни один запрос не упёрся в max_execution_time 30 секунд. При жёстком memory_limit 128M два файла по ~1 МБ, которые не поместились бы в память, плагин пропустил и назвал в отчёте. Файлы больше 3 МБ тоже пропускаются с пометкой.

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

• Токенайзер PHP (token_get_all()) вместо выполнения кода: файлы только читаются, ничего не подключается, код не покидает сервер.
• Правила для изменений PHP 7.0–8.5: синтаксис, который не загружается (фигурные скобки для элемента строки, вложенный тернарный оператор без скобок, (real) и (unset), =& new, классы с новыми зарезервированными именами), удалённые функции (each(), create_function(), get_magic_quotes_gpc(), money_format(), семейство ereg и другие), удалённые расширения (mysql, mcrypt, xmlrpc, imap, pspell, oci8), вызовы, ставшие фатальными (implode() с массивом первым, parse_str() без результата, mktime() без аргументов), изменённое поведение (конструкторы в стиле PHP 4, is_resource() на ресурсах, ставших объектами, assert() с кодом в строке), устаревшее до PHP 8.5 (неявно nullable параметры, типы возврата для 188 встроенных классов и интерфейсов, utf8_encode(), strftime(), FILTER_SANITIZE_STRING, E_STRICT, curl_close(), imagedestroy() и другое).
• Сверка с самим PHP: на 40 768 файлах 70 плагинов проверка нашла все 557 предупреждений об устаревшем, которые PHP 8.5 выдаёт при компиляции, а файлы, которые не компилируются на PHP 8.5, совпали с файлами, где она нашла незагружаемый синтаксис (10 из 10). Находки одинаковые, на каком бы PHP — 7.4, 8.3 или 8.5 — проверка ни работала.
• Защищённый код — проверка версии PHP, function_exists(), extension_loaded() или defined() вокруг кода или перед &&, || и ?, а также собственные замены удалённых функций в плагине распознаются, чтобы не пугать кодом, написанным под обе версии.
• Шаги с блокировкой: проверка идёт шагами по одному — вторая вкладка, WP-Cron и WP-CLI не читают одни и те же файлы одновременно; предохранитель памяти пропускает слишком большие файлы и называет их в отчёте; папка без прав чтения не обрывает проверку — отчёт говорит, сколько файлов не удалось прочитать.
• Данные php.net о ветках PHP кешируются на 12 часов; если запрос выключен, плагин берёт встроенный список. Таблица совместимости WordPress и PHP встроена в плагин.
• Свои таблицы для находок и журнала работы; удаление плагина убирает таблицы, настройки и задания крона, на мультисайте — на всех сайтах.

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

1. Плагины → Добавить новый → Загрузить плагин: выберите catcode-php-upgrade-check-for-woocommerce-free-1.0.0.zip и активируйте.
2. Инструменты → PHP Upgrade Check → выберите версию в «Переходим на PHP» → «Запустить проверку».
3. Посмотрите отчёт, «Подробнее» с исправлениями и, если нужно, скачайте CSV для разработчика.
4. Для Pro: загрузите Pro-сборку плагина поверх бесплатной (WordPress предложит заменить установленную версию) и вставьте лицензионный ключ из письма на вкладке «Настройки» — или нажмите там «Попробовать Pro 7 дней».