Как узнать и обновить версию PHP: phpinfo, CLI и хостинг
В терминале версию PHP показывает команда php -v, а на сайте её можно узнать через PHP_VERSION или phpinfo(). На одном сервере эти проверки могут дать разные результаты. Перед обновлением выясните, какой PHP обслуживает сайт, запускает cron и выполняет команды Composer.
Как узнать версию PHP в CLI
Выполните команду в той же среде, где работает приложение. Для проекта в Docker это обычно контейнер, а для удалённого сайта — оболочка на сервере. Команда выводит полную версию, например 8.4.x, где последнее число обозначает выпуск внутри ветки. Пометка (cli) указывает на интерфейс командной строки.
# Версия PHP, которую запускает текущая оболочка
php -v
# Загруженный php.ini и подключённые конфигурационные файлы
php --ini
# Расширения, доступные в CLI
php -mЕсли поиск по php version привёл к команде php version, используйте php -v или php --version. Слово version без дефисов PHP воспринимает как имя файла. Когда установленная версия расходится с ожидаемой, проверьте путь к исполняемому файлу. В Bash выполните command -v php, в PowerShell — Get-Command php -All. На сервере с несколькими версиями задайте проверенный абсолютный путь к нужному PHP в заданиях cron и сценариях развёртывания.
Как узнать версию PHP на сайте через PHP_VERSION и phpinfo()
Для веб-проверки откройте диагностический маршрут самого приложения или временный PHP-файл в каталоге, из которого обслуживается нужный домен. Выполните проверку через тот же домен и бэкенд, которые принимают обычные запросы. Для ответа достаточно констант PHP_VERSION и PHP_SAPI. Значение fpm-fcgi обычно означает PHP-FPM, а apache2handler — PHP как модуль Apache.
<?php
declare(strict_types=1);
// Короткий отчёт от PHP, который обработал веб-запрос.
header('Content-Type: text/plain; charset=UTF-8');
echo PHP_VERSION, PHP_EOL;
echo PHP_SAPI, PHP_EOL;Когда нужна страница phpinfo
Функция phpinfo() выводит диагностический отчёт PHP. Если ищете «php info», точное имя функции пишется слитно. В отчёте смотрите на Server API, Loaded Configuration File, список дополнительных INI-файлов и секции расширений. В таблицах настроек Local Value показывает значение, действующее для запроса, а Master Value помогает определить, переопределено ли оно на уровне сайта или пула.
<?php
declare(strict_types=1);
// Сведения о сборке, настройки и загруженные расширения.
phpinfo(INFO_GENERAL | INFO_CONFIGURATION | INFO_MODULES);Используйте отчёт за авторизацией или с ограничением доступа по IP. Он раскрывает пути, параметры и состав окружения. Для разовой проверки версии достаточно первого примера. Удалите временный файл сразу после проверки и убедитесь, что он больше не открывается.
Где посмотреть и поменять версию PHP на хостинге
В панели хостинга откройте настройки конкретного сайта или домена и найдите раздел «Версия PHP», «Настройки PHP» или «PHP Selector». Проверьте также настройки поддоменов. На одном аккаунте основной сайт, тестовый поддомен и фоновые задания могут работать на разных версиях. Если селектор действует на весь аккаунт, заранее выясните, какие сайты затронет переключение.
- Запишите текущую версию, обработчик PHP и включённые расширения.
- На тестовом сайте выберите целевую ветку и восстановите нужные параметры и расширения. Сохраните настройки.
- Откройте диагностический маршрут через браузер и проверьте приложение. Отдельно проверьте PHP в SSH и заданиях планировщика.
- Когда тесты пройдут, переключите рабочий домен и повторите проверку через него.
Если панель показывает новую версию, а браузер — прежнюю, проверьте, какой каталог и обработчик назначены домену, вступили ли настройки в силу и не закэширован ли ответ. Если сайт обслуживают несколько экземпляров приложения, версия должна совпасть на каждом из них.
Актуальная версия PHP и отличия веток 8.3–8.5
Сначала выберите поддерживаемую ветку, совместимую с проектом, затем установите свежий доступный патч этой ветки. Ветка с активной поддержкой получает исправления ошибок и безопасности. После завершения активной поддержки остаются исправления безопасности. Для планирования обновления важен срок поддержки выбранной ветки, а для диагностики — полный номер установленного выпуска.
| Ветка | Что появилось | Что проверить при переходе |
|---|---|---|
| PHP 8.3 | Типизированные константы классов, атрибут #[\Override], функция json_validate() | Для #[\Override] сверить методы с родительским классом или интерфейсом. json_validate() использовать, когда нужно проверить JSON без получения декодированных данных. |
| PHP 8.4 | Хуки свойств, асимметричная видимость свойств, array_find() и array_any() | Исправить объявления с неявно допускающим null типом, например заменить string $name = null на ?string $name = null. |
| PHP 8.5 | Оператор передачи результата |>, функции array_first() и array_last() | Убедиться, что зависимости и инструменты анализа поддерживают 8.5. Файлы с новым синтаксисом должны запускаться на PHP 8.5 или новее, в том числе в CI. |
Под запросом «PHP последняя версия» могут иметь в виду самую новую стабильную ветку или последний патч уже используемой ветки. На рубеже 2026 года при выборе между 8.3, 8.4 и 8.5 ориентируйтесь на совместимость зависимостей, доступность расширений и оставшийся срок поддержки. Даже если хостинг предлагает более новую ветку, сначала прогоните на ней проект целиком.
В объявлениях функций используйте типы параметров и результата. Директива declare(strict_types=1) задаётся в начале файла и для скалярных аргументов действует со стороны вызывающего файла. Входные данные из форм, окружения или API всё равно нужно проверять и преобразовывать явно. Если одна кодовая база должна работать на 8.3 и 8.5, держите синтаксис совместимым с 8.3. Условие по версии не спасёт файл с более новым синтаксисом от ошибки разбора.
Как обновить PHP на сервере и в Docker
До переключения сохраните резервную копию приложения, базы и конфигурации, зафиксируйте версии PHP и расширений. Для тестовой среды используйте тот же обработчик, что и для рабочего сайта. Проверьте ограничения require.php в composer.json и совместимость зафиксированных зависимостей. При переходе через несколько веток проверьте несовместимые изменения каждой промежуточной ветки.
# В каталоге проекта с composer.lock: причины, мешающие перейти на 8.5.0
composer prohibits php 8.5.0 --locked
# Под целевым PHP: реальные требования установленных зависимостей
composer check-platform-reqsВ первой команде подставьте полный номер целевого выпуска. Вторую запускайте после установки зависимостей в целевой среде. Она проверяет PHP и расширения, доступные самому Composer, даже если в проекте задано config.platform.php. Расширения в PHP-FPM проверьте отдельно. Если зависимость блокирует переход, обновите её в тестовой среде и проверьте изменения в composer.lock. Избегайте --ignore-platform-reqs при развёртывании.
Сервер с PHP-FPM
Установите пакеты целевой версии и нужные модули из репозитория для своего дистрибутива. Если пакеты позволяют, оставьте старый пул до завершения проверки. Сопоставьте настройки нового пула со старым: пользователя, права на сокет, переменные окружения, лимиты и параметры OPcache. Переносите нужные значения в конфигурацию новой версии, учитывая изменившиеся директивы.
# Пример для PHP-FPM 8.5. Сверьте путь с директивой listen в пуле.
fastcgi_pass unix:/run/php/php8.5-fpm.sock;Замените fastcgi_pass в существующей конфигурации сайта, сохранив остальные параметры передачи запроса. Запустите новый пул, выполните nginx -t и после успешной проверки перечитайте конфигурацию Nginx. Для Apache с PHP-FPM переключается бэкенд обработчика. Для Apache с модулем PHP потребуется переключить сам модуль. В обоих случаях проверьте конфигурацию веб-сервера до её применения.
Проект в Docker
Измените тег базового образа PHP, сохранив нужный вариант образа, например FPM. Пересоберите образ с системными библиотеками и PHP-расширениями, затем пересоздайте контейнеры. Проверьте контейнеры веб-приложения, воркеров и планировщика. В многостадийной сборке учитывайте PHP в стадии, где Composer устанавливает зависимости. Для быстрого отката сохраните предыдущий рабочий образ и конфигурацию запуска.
Типичные ошибки после обновления PHP
- CLI показывает новую версию, сайт — старую. Команды в оболочке и веб-запросы обслуживают разные процессы. Проверьте путь к PHP в оболочке, сокет FPM в конфигурации сайта и
PHP_SAPIв браузере. - Сайт отвечает 502 после переключения FPM. Проверьте, запущен ли новый пул, совпадает ли адрес в
fastcgi_passсlistenи есть ли у веб-сервера доступ к сокету. Уточните причину в журналах веб-сервера и FPM. - Появилась ошибка
could not find driverили пропал класс расширения. Установите нужный модуль для целевой версии и проверьте, что он загружен именно в проблемном процессе. Для PDO проверьте драйвер конкретной базы, напримерpdo_mysqlилиpdo_pgsql. - После перехода появились сообщения
Deprecated. Найдите вызов по журналу. Обновите затронутую зависимость или исправьте свой код. На рабочем сайте вывод ошибок посетителям держите отключённым, а запись в журнал — включённой. - Сайт работает, а задания очереди падают. Проверьте интерпретатор и расширения в службе воркера или cron. Перезапустите долгоживущие воркеры после обновления, чтобы они загрузили новую среду.
Чек-лист перед переключением рабочего сайта
- Зафиксируйте полную версию PHP и список расширений для сайта, CLI, cron и воркеров.
- Выберите целевую ветку и патч, проверьте зависимости Composer и подготовьте резервную копию.
- На тестовой среде проверьте вход, запись и чтение из базы, загрузку файлов и хотя бы одно фоновое задание. Сверьте журналы PHP и веб-сервера.
- После переключения подтвердите новую версию через рабочий домен и перезапустите долгоживущие процессы. Снова проверьте ключевые операции приложения.
- Уберите временную диагностику. Если понадобился откат, верните предыдущий пул или образ вместе с совместимым выпуском приложения. Если обновление включало миграции базы, действуйте по плану отката этих миграций.
Частые вопросы
Почему php -v и phpinfo() показывают разные версии PHP?
Команда php -v проверяет интерпретатор, который запускает текущая оболочка. Веб-страница с phpinfo() показывает PHP, обработавший HTTP-запрос. У них могут различаться версия, набор расширений и загруженный php.ini.
Как узнать версию PHP на хостинге без SSH?
Посмотрите настройки PHP для нужного домена в панели хостинга. Чтобы подтвердить фактическую версию, откройте защищённый диагностический маршрут, который выводит PHP_VERSION.
Можно ли обновить PHP 8.3 сразу до PHP 8.5?
Да. Проверьте изменения PHP 8.4 и 8.5, совместимость зависимостей и наличие нужных расширений. Прогоните тесты на PHP 8.5 и подготовьте откат перед переключением рабочего сайта.