1С Битрикс · 7 мин чтения

Битрикс на PHP 8: что ломается при переходе и как проверить сайт

Хостинги один за другим поднимают минимальную версию PHP до 8.1-8.3 и отключают поддержку PHP 7.4. Для сайта на Битрикс переход на PHP 8 часто превращается в неприятный сюрприз: часть кода не падает с ошибкой на экране, а просто перестаёт работать правильно, часть валится fatal error прямо в браузере у клиента. Ниже разбираю, что конкретно ломается в Битриксе на PHP 8 и как проверить сайт до того, как хостинг переключит версию за вас.

Что ломается в Битриксе при переходе на PHP 8

За десять с лишним лет на битриксовых проектах я насмотрелся на одни и те же поломки. Они привязаны не к самому Битриксу, а к изменениям языка, но именно в старом кастомном коде 1С-Битрикс всплывают чаще всего, потому что там годами копились обходные решения под старые версии PHP.

Конструкторы в стиле PHP4 и фигурные скобки в строках

До PHP 8 метод класса с тем же именем, что и сам класс, работал как конструктор (в PHP 7 уже с предупреждением E_DEPRECATED). Начиная с PHP 8 такие конструкторы больше не выполняются автоматически. Ошибки на экране не будет, объект просто соберётся без инициализации нужных полей.

<?php
class OldStyleHelper
{
    public function OldStyleHelper($config)
    {
        $this->config = $config;
    }
}

$helper = new OldStyleHelper(['mode' => 'test']);
var_dump($helper->config ?? null);
// на PHP 8 выведет NULL, конструктор не отработал

Второй частый гость в старых кастомных модулях и шаблонах компонентов: обращение к символу строки или элементу массива через фигурные скобки, вроде $str{0}. На PHP 8 это уже не предупреждение, а фатальная ошибка парсера, страница просто не откроется.

Удалённые функции: create_function() и each()

Обе функции убрали из языка в PHP 8.0. Если где-то в старом самописном модуле или в коде, унаследованном от предыдущего подрядчика, встречается create_function() для генерации колбэков или each() в ручном переборе массива, вызов упадёт с ошибкой «Call to undefined function». Ищу такие места через обычный grep по кодовой базе перед любым обновлением PHP.

Null в аргументах встроенных функций и сравнение строк с числами

Начиная с PHP 8.1 передача null в параметр внутренней функции, который не объявлен как nullable, считается устаревшей практикой и пишет в лог предупреждение уровня deprecated. Для Битрикса это особенно чувствительно: например, CUser::GetByID($id) возвращает не готовый массив, а объект CDBResult, и получить данные можно через ->GetNext() или ->Fetch(). Если после этого код сразу передаёт возможно пустое поле в trim() или mb_strtolower() без проверки на null, на PHP 8.1 и новее лог быстро забивается тысячами одинаковых предупреждений.

Отдельно PHP 8 изменил правила сравнения строк с числами через ==: раньше 0 == "abc" считалось истиной, теперь нет. В старых обработчиках вебхуков и CRM-скриптах, где ID или статус из $_REQUEST сравнивают нестрогим оператором, такие сравнения могут внезапно повести себя иначе.

Как проверить сайт на Битрикс перед переходом на PHP 8

Проверяю всегда на копии сайта, не на боевом окружении. Разворачиваю staging с той версией PHP, на которую собираюсь переходить, переключаю error_reporting(E_ALL) и вывод ошибок в лог, а не на экран, и прохожу по сайту руками, а не только глазами по коду.

Что проверить Как проверить Чем грозит, если пропустить
Оформление заказа и корзина Пройти заказ от добавления товара до оплаты на staging Клиент не может оформить заказ, деньги теряются в моменте
Формы и личный кабинет Отправить каждую форму сайта, зайти под тестовым пользователем Заявки перестают доходить незаметно для владельца сайта
Агенты и фоновые задачи Проверить по списку агентов (Настройки > Настройки продукта > Агенты) и логу, что агенты отрабатывают без ошибок Рассылки, обновление остатков и другие фоновые операции тихо перестают работать
Интеграции и вебхуки Битрикс24 Отправить тестовое событие на обработчик, свериться с логом CRM перестаёт получать данные с сайта без видимой ошибки
Кастомные модули и компоненты Прогнать код через статический анализ на совместимость с PHP 8 Часть страниц падает фатальной ошибкой у случайных посетителей

После прогона смотрю не только на то, что показалось в браузере, но и на лог PHP-FPM и лог самого Битрикса: часть проблем не ломает страницу визуально, а просто копится в фоне.

Бесплатный материал

🎁 Полезный скрипт в подарок

Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.

Без спама. Отписка в 1 клик.

Проверка кастомного кода: где искать проблемы в первую очередь

Ядро Битрикса вендор обновляет сам, и в актуальных версиях оно уже адаптировано под современный PHP. Ломается почти всегда кастомный код, а кастомный код в правильно собранном проекте лежит в одном месте: «при обработке папок приоритет всегда у папки /local перед /bitrix», то есть все доработки должны идти через /local, а не через прямую правку файлов в /bitrix/components и /bitrix/templates. Если в проекте правки размазаны по обеим папкам, первым делом свожу их в /local, иначе следующее обновление ядра просто затрёт часть доработок поверх найденных проблем с PHP 8.

Дальше кастомный код удобно прогнать статическим анализатором на совместимость с нужной версией PHP, не открывая руками каждый файл:

vendor/bin/phpcs -p ./local --standard=PHPCompatibility --runtime-set testVersion 8.1

Отдельно стоит поднять модули, установленные из Маркетплейса 1С-Битрикс: если разработчик модуля давно не обновлял решение, совместимость с PHP 8 никто не гарантирует, и такой модуль стоит либо обновить у автора, либо переписать самостоятельно. На практике это самая частая причина, по которой клиенты приходят с просьбой посмотреть, почему после смены версии PHP на хостинге сайт частично перестал работать. Если самостоятельно разбирать чужой унаследованный код на Битриксе не хочется, для таких задач у меня есть доработка и поддержка 1С-Битрикс: беру точечные правки после аудита без переписывания всего проекта.

Агенты, вебхуки Битрикс24 и фоновые задачи на PHP 8

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

Если в проекте агенты давно вынесены на cron через собственный /bitrix/php_interface/cron_events.php, отдельно проверяю путь до бинарника PHP в crontab: после обновления версии на хостинге старая запись в расписании иногда продолжает дёргать php7-бинарник, который никуда не делся, просто перестал быть версией по умолчанию.

Обработчики исходящих вебхуков Битрикс24 обычно пишут как обычный PHP-скрипт на хостинге, принимающий POST в формате application/x-www-form-urlencoded. Сам формат от версии PHP не зависит, а вот код внутри обработчика, если он старый и использует те же устаревшие функции или нестрогие сравнения ID сделок и статусов, ломается по тем же причинам, что и остальной кастомный код.

План перехода: пошаговый чек-лист

Порядок, которого придерживаюсь сам при переводе клиентских проектов на новую версию PHP:

  1. Снять копию сайта на staging с целевой версией PHP.
  2. Включить полный вывод ошибок в лог и пройти ключевые сценарии сайта руками: заказ, формы, личный кабинет, админку.
  3. Прогнать кастомный код из /local статическим анализатором на совместимость с нужной версией.
  4. Свести правки, если они исторически лежат в /bitrix, обратно в /local.
  5. Проверить модули из Маркетплейса на предмет актуальных обновлений под PHP 8.
  6. Проверить по списку агентов и логу, что агенты отрабатывают без ошибок, и проверить обработчики вебхуков Битрикс24 тестовыми событиями.
  7. Только после чистого прогона на staging переключать боевой сайт и следующие сутки держать лог под наблюдением.

Требования 1С-Битрикс к версии PHP и состав модулей в Маркетплейсе меняются, поэтому перед переходом клиента на новую версию я всегда сверяюсь с актуальной документацией вендора, а не полагаюсь на то, что работало год назад.

Частые вопросы

Какую версию PHP поддерживает актуальная редакция Битрикса?

Официальные требования по поддерживаемым версиям PHP публикует сам вендор и периодически их пересматривает вместе с обновлением ядра, поэтому перед переходом смотрю действующий список в документации, а не ориентируюсь на то, что стояло на проекте раньше.

Сайт после перехода на PHP 8 не падает, но в логе тысячи deprecated-предупреждений. Это опасно?

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

Нужно ли обновлять ядро Битрикса перед переходом на PHP 8?

Актуальное ядро вендор уже адаптирует под свежие версии PHP, поэтому обновление ядра почти всегда идёт раньше или вместе со сменой версии PHP, а не после неё. Переходить на PHP 8 на сильно устаревшем ядре рискованно вдвойне: ломается и старый кастомный код, и часть логики самого ядра, рассчитанной на более старый PHP.

Сколько стоит проверить и доработать сайт на Битрикс под PHP 8?

Провожу такие задачи в почасовом формате: доработка и поддержка 1С-Битрикс у меня стоят от 3 000 ₽ в час, а конкретная оценка зависит от объёма кастомного кода и количества модулей из Маркетплейса на проекте.

Есть задача?

Обсудим вашу задачу

Оставьте заявку — обсудим объём работ и следующий шаг.

Продолжая пользование настоящим сайтом Вы выражаете своё согласие на обработку Ваших персональных данных (файлов куки) с использованием Yandex.Metrika.
Понятно