Перевод проекта на 1С-Битрикс на PHP 8.2 и выше: пошаговый план для бесшовного обновления

Поддержка PHP 7.x прекращена. Это не просто пустая формальность, а прямой риск для безопасности и производительности вашего сайта. Для владельцев сайтов на 1С-Битрикс это означает, что обновление до PHP 8.2 или выше — уже не вопрос выбора, а острая необходимость. Однако просто переключить версию в панели управления хостингом нельзя — сайт, написанный для устаревших версий, гарантированно сломается.

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

В основе нашей статьи — опыт экспертов, объединенный в одну универсальную инструкцию.

1. Последовательность действий: как обновить PHP на вашем проекте

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

Рассказываем, как безопасно повысить версию PHP   на 1С- Битрикс.

Шаг 1. Создать эталонную точку возврата: полный бэкап и создать тестовую площадку

Перед любыми действиями на живом сайте необходимо зафиксировать его текущее состояние.

Сделайте полную резервную копию всех файлов сайта и базы данных. В идеале, если ваш хостинг или сервер позволяют, создайте снапшот (snapshot) виртуальной машины. Это позволит откатиться до состояния «до обновления» за секунды в случае критической ошибки.

Шаг 2. Включить режим «технических работ»

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

В административной панели Битрикс перейдите в «Настройки» > «Настройки продукта» > «Настройки модуля «Главный модуль» и нажмите кнопку «Закрыть доступ для посетителей». Авторизованные администраторы смогут зайти и проверить работоспособность.

Шаг 3. Актуализировать ядро и модули (на текущей версии PHP) на тестовой площадке

Это критически важный пункт. Нельзя переключать PHP, если ядро Битрикса устарело.

Убедитесь, что ваша лицензия на Битрикс активна (срок действия истек? — продлите). Затем перейдите в Администрирование > Обновления платформы` и обновите ядро и все установленные модули до последних доступных версий. Это нужно сделать до переключения PHP, чтобы получить совместимый с новыми версиями код от разработчиков.

Важно:  проверьте лицензии на сторонние модули из Маркетплейса. Если поддержка по ним закончилась, их необходимо продлить (обычно это 50% от стоимости решения), иначе после обновления PHP они, скорее всего, перестанут работать.

Шаг 4. Переключить PHP и обновить зависимости

Теперь приступаем к ключевому моменту — смене версии интерпретатора.

1. В панели управления хостингом или на сервере переключите версию PHP на целевую (например, 8.2 или 8.3).
2. Если в проекте используется Composer (менеджер зависимостей для PHP), необходимо выполнить команду `composer update` в корне сайта, чтобы подтянуть версии библиотек, совместимые с новой версией PHP.

Шаг 5. Финальное обновление Битрикса

Иногда после смены версии PHP становятся доступны дополнительные обновления платформы.

Еще раз зайдите на страницу обновлений (`/bitrix/admin/update_system.php`). Если система предлагает установить новые версии модулей или самого ядра (вышедшие специально под вашу версию PHP) — сделайте это.

Если на тестовой площадке вы или ваши разработчики уже исправили все ошибки несовместимости в кастомных компонентах, шаблонах или скриптах, пришло время обновить Битрикс и модули на живом сайте, и перенести эти правки на живой сайт.

Выгрузите заранее подготовленные и протестированные правки кода (например, из Git-репозитория) на сервер. Важно раскатывать только правки, связанные с обновлением, а не новый функционал.

Шаг 7. Очистка и прогрев кэша

Чтобы изменения вступили в силу и сайт работал быстро, необходимо сбросить старый кэш.

В административной панели перейдите в «Настройки» > «Настройки продукта» > «Управление кэшем» и нажмите «Очистить все». После этого рекомендуется «прогреть» кэш, пройдя по главным страницам сайта (или используя специальные скрипты), чтобы первые посетители не ждали генерации страниц.

Шаг 8. Экспресс-проверка ключевых сценариев

Сайт все еще закрыт на технические работы, но администраторы имеют к нему доступ. Убедитесь, что всё работает.

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

Шаг 9. Завершение работ и мониторинг

Если все ключевые сценарии работают корректно, можно открывать сайт.

Снимите галочку «Закрыть доступ для посетителей» в настройках главного модуля.

Пост-релиз:внимательно следите за логами ошибок (в `/bitrix/php_interface` или на сервере) в течение ближайших суток. Некоторые ошибки, особенно в агентах или редко используемых разделах, могут проявиться не сразу.

2. Как исправлять типовые ошибки перехода с PHP 7.x на PHP 8.x

Даже если вы все сделали правильно, иногда код может давать сбои.

PHP 8 стал сложнее и строже. Вот список самых частых ошибок и способы их решения. Эти правки вносятся в кастомный код сайта (в папке `/local/`), а не в ядро Битрикса.

2.1.   Нестатичный метод вызывается статично

Ошибка: `[TypeError] call_user_func_array(): Argument #1 ($callback) must be a valid callback, non-static method ... cannot be called statically`

Решение: в определении класса, где находится метод (например, `CKladr::SetLocation`), перед ним нужно дописать слово `static`.

```php

// Было:

public function SetLocation(){ ... }

 

// Стало:

public static function SetLocation(){ ... }

```

2.2.     Нет проверки типа данных для функций массивов

PHP 8 требует, чтобы в функции для работы с массивами (`count`, `array_key_exists`, `in_array`, `implode`) передавался именно массив, а не `null`, `string` или `bool`.

Ошибка: `[TypeError] count(): Argument #1 ($value) must be of type Countable|array, null given`

Решение: добавить проверку `is_array()` перед вызовом функции.

```php

// Было:

if(count($arResult['ITEMS']) > 5) { ... }

 

// Стало:

if(is_array($arResult['ITEMS']) && count($arResult['ITEMS']) > 5) { ... }

```

Аналогично для `in_array`:

```php

// Было:

if(in_array($value, $arShowValues))

// Стало:

if(is_array($arShowValues) && in_array($value, $arShowValues))

```

2.3.  Ключ в массиве без кавычек

Классическая неточность, которая теперь приводит к фатальной ошибке, если константа с таким именем не определена.

Ошибка:  `Undefined constant "HTTP_USER_AGENT"`

Код:  `$_SERVER[HTTP_USER_AGENT]`

Решение: всегда заключать строковые ключи ассоциативных массивов в кавычки.

```php

$_SERVER['HTTP_USER_AGENT']

```

2.4.  Обращение к строке как к массиву через фигурные скобки

Старый синтаксис доступа к символу строки `{}` больше не работает.

Ошибка: `Array and string offset access syntax with curly braces is no longer supported`

Код: `$char = $string{0};`

Решение: использовать квадратные скобки.

```php

$char = $string[0];

```

2.5. Отсутствует аргумент функции

Некоторые функции теперь требуют обязательного наличия аргумента.

Ошибка: `[ArgumentCountError] mktime() expects at least 1 argument, 0 given`

Решение: Передать аргумент, даже если это `0`.

```php

// Было:

$time = mktime();

// Стало:

$time = mktime(0);

```

2.6. Конструктор класса назван неправильно

В старых модулях конструктор называли по имени класса. В PHP 8 нужно использовать `__construct()`.

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

Решение: В файле `include.php` стороннего модуля заменить имя класса-конструктора на `__construct()`.

```php

// Было:

function recaptchafree() { ... }

// Стало:

function __construct() { ... }

```

3. Что должно получиться в итоге

Грамотно выполненный перевод проекта на PHP 8.2+ дает ощутимые преимущества:

Скорость: прирост производительности до 20–40% без изменения логики работы.

Безопасность: вы получаете актуальные патчи безопасности от сообщества PHP и от разработчиков Битрикса.

Стабильность: исчезают «старые» технические ошибки и предупреждения.

Будущее: вы снова можете обновлять ядро Битрикса и устанавливать современные модули.

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

Если вы сами решили обновить PHP 7.x на PHP 8.x, но не до конца уверены в своих силах – не спешите. Мы поможем вам повысить версию PHP и избежать возможных ошибок, а также сэкономить ваше время.