PHPTime

Как узнать и обновить версию PHP: phpinfo, CLI и хостинг

В терминале версию PHP показывает команда php -v, а на сайте её можно узнать через PHP_VERSION или phpinfo(). На одном сервере эти проверки могут дать разные результаты. Перед обновлением выясните, какой PHP обслуживает сайт, запускает cron и выполняет команды Composer.

Как узнать версию PHP в CLI

Выполните команду в той же среде, где работает приложение. Для проекта в Docker это обычно контейнер, а для удалённого сайта — оболочка на сервере. Команда выводит полную версию, например 8.4.x, где последнее число обозначает выпуск внутри ветки. Пометка (cli) указывает на интерфейс командной строки.

Shell
# Версия 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
<?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
<?php
declare(strict_types=1);

// Сведения о сборке, настройки и загруженные расширения.
phpinfo(INFO_GENERAL | INFO_CONFIGURATION | INFO_MODULES);

Используйте отчёт за авторизацией или с ограничением доступа по IP. Он раскрывает пути, параметры и состав окружения. Для разовой проверки версии достаточно первого примера. Удалите временный файл сразу после проверки и убедитесь, что он больше не открывается.

Где посмотреть и поменять версию PHP на хостинге

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

  1. Запишите текущую версию, обработчик PHP и включённые расширения.
  2. На тестовом сайте выберите целевую ветку и восстановите нужные параметры и расширения. Сохраните настройки.
  3. Откройте диагностический маршрут через браузер и проверьте приложение. Отдельно проверьте PHP в SSH и заданиях планировщика.
  4. Когда тесты пройдут, переключите рабочий домен и повторите проверку через него.

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

Актуальная версия 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 и совместимость зафиксированных зависимостей. При переходе через несколько веток проверьте несовместимые изменения каждой промежуточной ветки.

Shell
# В каталоге проекта с 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. Переносите нужные значения в конфигурацию новой версии, учитывая изменившиеся директивы.

nginx
# Пример для 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. Перезапустите долгоживущие воркеры после обновления, чтобы они загрузили новую среду.

Чек-лист перед переключением рабочего сайта

  1. Зафиксируйте полную версию PHP и список расширений для сайта, CLI, cron и воркеров.
  2. Выберите целевую ветку и патч, проверьте зависимости Composer и подготовьте резервную копию.
  3. На тестовой среде проверьте вход, запись и чтение из базы, загрузку файлов и хотя бы одно фоновое задание. Сверьте журналы PHP и веб-сервера.
  4. После переключения подтвердите новую версию через рабочий домен и перезапустите долгоживущие процессы. Снова проверьте ключевые операции приложения.
  5. Уберите временную диагностику. Если понадобился откат, верните предыдущий пул или образ вместе с совместимым выпуском приложения. Если обновление включало миграции базы, действуйте по плану отката этих миграций.

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

Почему 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 и подготовьте откат перед переключением рабочего сайта.

Справка по теме

Ещё в разделе «Справочник PHP»

Как установить PHP на Windows, Linux и macOS

Как скачать и установить PHP 8.3–8.5 на Windows, Linux и macOS, настроить PATH и php.ini, подключить расширения и проверить работу PHP в терминале и браузере.

8 мин

Классы и ООП в PHP 8: свойства, конструктор, наследование

Как объявлять классы в PHP 8.3–8.5, типизировать свойства, писать конструкторы и наследовать классы. Примеры с self, static, parent и readonly.

9 мин

Константы в PHP: define, const и константы классов

Как объявлять константы в PHP через define и const, работать с константами классов, проверять их наличие и учитывать отличия PHP 8.3, 8.4 и 8.5.

7 мин

Массив в строку и строку в массив: implode, explode, json, serialize

Как преобразовать массив в строку и обратно в PHP 8.3–8.5: implode, explode, preg_split, JSON и serialize. Как вывести массив через print_r и var_dump.

9 мин