Переход на версию PHP 7.4 и выше

На данный момент репозитории CentOS 7 отключены. Для выполнения обновлений и установки новых пакетов необходимо подключить Vault-репозитории. Для этого выполните следующие команды:

sed -i 's/^mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*
sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*

CMS «Битрикс» рекомендует своим пользователям использовать версию PHP 8.1 и выше. В инструкции мы рассмотрим, как это сделать.

Отдельные PHP-модули могут мешать выполнению обновления по этой инструкции (например, если нужного модуля под новую версию PHP просто нет). Если вы столкнулись с проблемами при смене версии PHP — напишите в поддержку из своей панели управления, мы поможем разобраться.

Шаг 1. Обновление версии BitrixEnv

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

Далее подключитесь к серверу по SSH и выполните в меню Bitrix следующие действия.

Если версия BitrixEnv ниже 7.5.x

Сначала необходимо обновить версию окружения до актуальной (7.5+). 

Для обновления до 7.5. выполните:

1. Выберите пункт 1. Manage servers in the pool, затем 4. Update packages on host.
2. При запросе Enter server address введите IP-адрес сервера: 
   
3. При запросе Please choose update type введите на выбор: bitrix — для обновления только BitrixEnv до актуальной версии, либо all для обновления всех имеющихся пакетов, в том числе BitrixEnv: 
   
4. Дождитесь завершения обновления.

Теперь версия окружения — 7.5, и вы можете выполнить следующие шаги по инструкции. 

Если версия BitrixEnv 7.5 или выше

Переходите к обновлению версии PHP. 

Шаг 2. Обновление версии PHP

В BitrixEnv версии 7.5 вы можете изменить версию PHP на желаемую. Для этого:

1. В основном меню выберите пункт 1. Manage servers in the pool, затем 8. Update PHP and MySQL.
2. Введите all при запросе.
3. Выберите пункт 1. Upgrade PHP или 2. Downgrade PHP и выберите нужную версию PHP.
4. Введите y для подтверждения обновления.

Выбранная версия РНР будет установлена.

Если не удается выполнить обновление

Если обновление версии не происходит или завершается с ошибкой, необходимо отредактировать файл /etc/yum.repos.d/remi-phpXX.repo , где XX — версия PHP, которую нужно установить (например, php74, php80 и так далее).

Рассмотрим на примере PHP 8.1. 

Откройте файл в предпочитаемом редакторе, например:

nano /etc/yum.repos.d/remi-php81.repo

И замените его содержимое на следующее, указывая нужную версию PHP:

[remi-php81]
name=Remi's PHP 8.1 RPM repository for Enterprise Linux 7 - $basearch
#baseurl=http://rpms.remirepo.net/enterprise/7/php81/$basearch/
mirrorlist=https://rpms.remirepo.net/enterprise/7/php81/httpsmirror
mirrorlist=http://cdn.remirepo.net/enterprise/7/php81/mirror
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-remi

Сохраните изменения.

После снова выполните обновление версии PHP по инструкции выше.

Также, в процессе обновления bitrixenv может завершиться работа веб-сервера Nginx. Для решения проблемы необходимо создать обращение в поддержку.