Как обновить PHP на MODX: безопасная инструкция

Зачем вообще обновлять PHP

Каждая ветка PHP получает исправления только ограниченное время. Например, PHP 7.4 официально снят с поддержки в ноябре 2022 года: уязвимости в нём больше не закрываются, а значит, сайт на этой версии остаётся лёгкой целью для взлома. Актуальные сроки поддержки каждой ветки публикуются на официальном сайте PHP.

Вторая причина — требования окружения. Хостинги постепенно отключают старые версии, а свежие релизы дополнений вроде pdoTools, miniShop2 или FormIt выходят уже с расчётом на PHP 8. Если откладывать обновление годами, в какой-то момент придётся обновлять всё сразу и в аварийном режиме, когда хостинг отключит старую версию без предупреждения.

Третья причина — скорость. Современные версии PHP заметно быстрее обрабатывают запросы и экономят память. Быстрый ответ сервера улучшает пользовательские метрики, которые учитывают в оценке сайта и Яндекс, и Google.

Сначала выясните, с чем работаете

Перед любыми изменениями зафиксируйте текущее состояние. Откройте админку MODX и перейдите в раздел «Отчёты» → «Информация о системе»: там указаны версия MODX, версия PHP, лимит памяти и подключённые расширения. Список установленных дополнений и их версий смотрите в «Управлении пакетами» (Установщик).

Запишите эти данные: они понадобятся, чтобы сверить требования и при необходимости вернуть всё как было. Заодно оцените, сколько на сайте самописного кода — сниппетов, плагинов и модулей, созданных под заказ. Именно он чаще всего ломается при переходе на PHP 8, потому что у дополнений из официального каталога обычно есть обновления, а у кода десятилетней давности автора может не быть.

Бэкап и тестовая копия — обязательны

Резервная копия состоит из двух частей: всех файлов сайта (папки core, manager, connectors, assets и файлы в корне) и дампа базы данных. Дамп можно выгрузить через phpMyAdmin или Adminer, а на VPS — командой mysqldump. Обязательно проверьте, что архив открывается, а дамп не пустой: бэкап, который нельзя развернуть, бэкапом не является.

Затем разверните копию сайта на тестовом поддомене. Для этого скопируйте файлы, импортируйте базу и поправьте пути и параметры подключения к БД в файлах core/config/config.inc.php и config.core.php, а также в конфигурационных файлах папок manager и connectors. Важный момент для SEO: тестовый поддомен нужно закрыть паролем (например, через .htpasswd) или хотя бы запретить индексацию. Иначе Яндекс и Google могут проиндексировать дубль всего сайта.

Как переключить версию PHP на хостинге

На виртуальном хостинге версия PHP меняется в панели управления: ISPmanager, cPanel, Plesk или собственной панели провайдера. Обычно нужный пункт называется «PHP» или «Версия PHP» и находится в настройках сайта или домена. Обратите внимание на режим работы (mod_php, FastCGI, PHP-FPM): у разных режимов могут быть свои ограничения.

Сразу после смены проверьте расширения. Для MODX нужны как минимум pdo_mysql, curl, mbstring, xml, json и zip, а для работы с изображениями — gd или imagick. Для скорости стоит включить opcache. Лимит памяти (memory_limit) лучше выставить не ниже 256 МБ, особенно если на сайте магазин или тяжёлые сниппеты.

Учтите, что у каждой версии PHP на хостинге может быть собственный php.ini, и настройки старой версии автоматически не переносятся. На VPS процедура другая: ставится нужный пакет php-fpm, а в конфигурации nginx или Apache меняется путь к сокету. После этого службы перезапускаются.

Где искать причину ошибки

Главный инструмент диагностики — журнал ошибок. В админке MODX он находится в разделе «Отчёты» → «Журнал ошибок», а физически это файл core/cache/logs/error.log. Если после смены версии не открывается даже админка, смотрите логи самого хостинга: они обычно доступны в панели управления.

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

После каждого исправления очищайте кэш: удалите содержимое папки core/cache или воспользуйтесь командой очистки в админке. Иначе MODX может продолжить отдавать старые скомпилированные данные, и вы будете искать ошибку, которой уже нет.

Что делать с самописным кодом

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

Если код написан давно и никто не помнит, как он работает, лучше сначала описать его назначение, а потом решить, нужен ли он вообще. Часто функциональность старого сниппета сегодня закрывается штатными возможностями pdoTools или современными дополнениями, и вместо правок проще перейти на готовое решение.

Контроль после обновления

Сайт открылся и выглядит как прежде — это ещё не финал. Некоторые ошибки проявляются только на редких страницах или в определённое время, например при ночном импорте или при отправке редкой формы. Поэтому первую неделю после переключения стоит наблюдать за сайтом.

Смотрите на отчёты поисковых систем. В Яндекс Вебмастере проверяйте раздел с диагностикой сайта и статистикой обхода, в Google Search Console — отчёты о сканировании и индексировании страниц. Рост числа ответов 5xx или недоступных страниц — прямой сигнал, что после обновления что-то сломалось. В Яндекс Метрике и Google Analytics следите за резким падением конверсий и ростом отказов на ключевых страницах.