Как обновить PHP на Ubuntu: пошаговая инструкция

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

Каждая ветка PHP живёт ограниченное время. Сначала идёт активная поддержка, когда выходят и исправления ошибок, и патчи безопасности, затем год-два только патчи безопасности, после чего ветка получает статус EOL: уязвимости больше не закрываются. Работать на такой версии — значит оставлять в продакшене известные дыры.

Вторая причина — производительность. Начиная с PHP 8 в движке появился JIT-компилятор, а сам интерпретатор стал заметно быстрее версий 7.x. Для сайта это сокращение времени ответа сервера, а скорость отдачи страниц учитывают и Яндекс, и Google при оценке качества ресурса.

Третья причина — требования библиотек. Современные версии Laravel, Symfony, WordPress-плагинов и пакетов Composer всё чаще отказываются работать на PHP ниже 8.1. Чем дольше вы откладываете переход, тем больше разрыв и тем болезненнее будет обновление.

Репозиторий Ubuntu или PPA: что выбрать

В стандартных репозиториях Ubuntu для каждого релиза лежит одна основная версия PHP. Она стабильна, получает бэкпорты исправлений безопасности от Canonical, но не обновляется до следующей минорной ветки. Если вам нужна версия новее, чем в вашем релизе, придётся подключать внешний источник.

Де-факто стандартом стал PPA ppa:ondrej/php, который поддерживает Ondřej Surý — мейнтейнер PHP в Debian. В нём одновременно доступны сразу несколько веток: от 7.x до свежих 8.x. Пакеты собраны так же, как официальные, поэтому структура каталогов и сервисов остаётся привычной.

Если ваш проект работает на версии из репозитория Ubuntu и вас всё устраивает, отдельное обновление может быть и не нужно. Но когда требуется конкретная ветка, например 8.3 на Ubuntu 22.04, PPA — самый короткий путь.

Подготовка: что сделать до первой команды

Начните с инвентаризации. Выясните текущую версию командой `php -v`, список установленных пакетов — `dpkg -l | grep php`, а список загруженных расширений — `php -m`. Этот список пригодится: после установки новой версии расширения придётся поставить заново, они не переносятся автоматически.

Затем сделайте резервные копии. Скопируйте каталог `/etc/php`, конфигурации Apache или Nginx, файлы сайта и дампы баз данных. Если у вас облачный сервер, создайте снимок диска: это самый быстрый способ откатиться.

И наконец, проверьте совместимость кода. Запустите проект на новой версии в тестовом окружении, посмотрите логи на предупреждения об устаревших функциях (deprecated) и убедитесь, что `composer.json` разрешает новую версию PHP.

Расширения и версия PHP в консоли

Самая частая причина неработающего сайта после обновления — потерянные расширения. Сверьте вывод `php -m` на старой и новой версии и доустановите недостающие пакеты по шаблону `php8.3-имя`. Для базы данных это php8.3-mysql или php8.3-pgsql, для обработки изображений — php8.3-gd или php8.3-imagick, для интернационализации — php8.3-intl.

Когда на сервере стоит несколько версий, команда `php` в терминале может по-прежнему запускать старую. Переключить её можно через систему альтернатив: `sudo update-alternatives --config php` покажет список установленных версий и предложит выбрать нужную. Это влияет только на CLI: Composer, cron-задачи, консольные команды фреймворков. На работу сайта через веб-сервер переключение не влияет.

Проверка после переключения

Не ограничивайтесь командой `php -v`: она показывает версию CLI, а не ту, что обрабатывает запросы сайта. Создайте временный файл с вызовом `phpinfo()`, откройте его в браузере, убедитесь, что в поле PHP Version указана новая ветка, и сразу удалите файл — в открытом доступе он раскрывает слишком много информации о сервере.

После этого просмотрите логи: `/var/log/nginx/error.log` или `/var/log/apache2/error.log`, а также журнал PHP-FPM. Обратите внимание на предупреждения Deprecated и фатальные ошибки об отсутствующих функциях — они подскажут, каких расширений не хватает.

Отдельно настройте php.ini. Конфигурация новой версии лежит в собственном каталоге, например `/etc/php/8.3/fpm/php.ini`, и не наследует правки старой. Перенесите значения memory_limit, upload_max_filesize, post_max_size, max_execution_time и настройки OPcache вручную.

Как убрать старую версию PHP

Когда все сайты стабильно работают на новой ветке и в логах нет ошибок, старую версию можно удалять. Остановите её сервис командами `sudo systemctl stop php8.1-fpm` и `sudo systemctl disable php8.1-fpm`, затем выполните `sudo apt purge 'php8.1*'` и `sudo apt autoremove`. Ключ purge удаляет и конфигурационные файлы, поэтому убедитесь, что нужные настройки уже перенесены.

Если что-то пошло не так, откат делается просто: старая версия никуда не делась, пока вы её не удалили. Верните прежний fastcgi_pass или включите прежний модуль Apache, перезагрузите веб-сервер, а причину разберите уже без спешки.

Что проверить в проекте

Если проект использует Composer, выполните `composer check-platform-reqs`: команда покажет, соответствуют ли версия PHP и расширения требованиям зависимостей. Затем запустите `composer install` под новой версией, чтобы убедиться, что все пакеты разрешаются без конфликтов.

Не забудьте про cron и фоновые процессы. Задачи, запускаемые по расписанию, воркеры очередей и демоны вроде Supervisor часто вызывают php по абсолютному пути, и после переключения альтернатив они могут продолжать использовать старый бинарник. Проверьте такие места вручную.

После выката посмотрите на поведение сайта в Яндекс Метрике и Google Analytics: рост доли ошибок, падение времени на сайте или всплеск отказов в день обновления — повод сразу заглянуть в логи.