cat ~/blog/bitrix-php-update-preparation.md

Главная на новом PHP открылась. Рано радоваться

Новый PHP может показать главную и спокойно уронить обмен по cron ночью. Рассказываю, где я ищу такие различия до переключения боевого сайта.

С обновлением PHP есть обманчивый момент. Переключил версию, открыл главную — она работает. Каталог тоже открылся. Кажется, можно закрывать задачу.

А ночью не отработал обмен. Утром выясняется, что веб-сервер уже использует новый PHP, а cron остался на старом. Или наоборот. В админке тем временем не загружается файл из-за расширения, которого не хватило в новом окружении.

Главная здесь была очень слабым тестом. Она даже могла прийти из кеша.

Поэтому до переключателя в панели хостинга я отвечаю на простой вопрос: какие PHP вообще участвуют в жизни сайта.

У сайта может быть больше одного PHP

Команда в SSH показывает конфигурацию CLI. Битрикс в браузере обычно работает через PHP-FPM. Это разные процессы с собственными php.ini, расширениями и лимитами.

Сначала снимаю показания командной строки:

что видит CLI

Потом сверяю версию и настройки пула FPM. Отдельно выписываю ограничения памяти, загрузки файлов и времени выполнения. Часовой пояс тоже пригодится: обмен с датами умеет преподносить сюрпризы даже без фатальной ошибки.

Если на сервере несколько пулов, проверяю именно тот, к которому обращается виртуальный хост. Красивый вывод php -v сам по себе ничего не говорит о PHP посетителя сайта.

Расширение забывается чаще, чем версия

Новый PHP поставили, mbstring забыли. Сайт какое-то время может даже открываться, пока выполнение не дойдёт до нужного вызова. Тогда в логе появляется вполне конкретное:

php-error.log
Call to undefined function mb_convert_encoding()

Я сравниваю список расширений на старом и новом окружении, затем смотрю требования Битрикса и установленных решений. Старый php.ini целиком не переношу. Часть директив могла изменить название или смысл, а старый путь к расширению на новой версии вообще не существует.

Здесь же записываю версии модулей и ищу свой код: обработчики в init.php, шаблоны, скрипты обменов и локальные решения. О них документация ядра ничего не знает.

Копия не должна отправлять настоящие заказы

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

Почту направляю в тестовый почтовый ящик или Mailpit. Платежи перевожу в тестовый режим. Обмены отключаю либо направляю на отдельный контур. Иначе копия после восстановления вполне может начать работать как второй боевой сайт.

После запуска проверяю, что копия действительно использует целевой PHP. Включение нужной версии в соседнем пуле FPM не считается. Ошибки собираю в защищённый журнал и отмечаю время начала тестов, чтобы старые записи не мешали разбору.

`php -l` не нажимает кнопку «Оформить заказ»

Синтаксис я проверяю на целевой версии. Это быстро и полезно, но линтер не вызывает обработчики и не обращается к базе. Ошибки сигнатур или типов могут ждать конкретного действия пользователя.

В своих модулях я разделяю эти результаты. Например, линтер прогоняется на PHP 7.4 и 8.3, а полный цикл импорта и экспорта — на рабочем стенде с PHP 8.2. Зелёный линтер говорит о синтаксисе. Завершённый импорт говорит уже о поведении.

На копии смотрю и предупреждения. Deprecated сегодня не роняет заказ, зато подсказывает место, которое сломается позже. Понижать error_reporting ради чистого лога не стоит: сообщение исчезнет, несовместимость останется.

Мой маршрут по тестовой копии

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

Оплата проверяется только в тестовом режиме. Для обменов использую отдельные доступы и тестовые объекты. Задание cron запускаю через CLI на целевой версии, потому что браузерный сценарий ничего о нём не доказал.

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

Возврат PHP не откатывает базу

Перед работами сохраняю согласованную копию файлов и базы. В плане записываю порядок обновления модулей, применение своих исправлений, переключение FPM и контрольные действия. Для каждого шага нужен понятный результат.

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

Старое окружение стоит сохранить до конца наблюдения. Оно пригодится и для отката, и для сравнения поведения.

Что должно быть готово до переключения

  1. Версии PHP в CLI и FPM известны.
  2. Расширения и параметры нового окружения сверены.
  3. Копия изолирована от настоящих платежей и обменов.
  4. На целевой версии оформлен заказ. Админка и фоновые задания тоже проверены.
  5. Есть копия файлов и базы одного состояния.
  6. Понятно, как вернуть прежнее приложение без потери свежих данных.

Только после этого я переключаю боевой сайт. И главную, разумеется, тоже открываю. Просто теперь она стоит в списке среди остальных проверок. Одной её недостаточно.

man zelenkindev

Горячие клавиши

/
поиск по модулям
?
эта справка
Esc
закрыть