Успешный Composer в консоли подтверждает окружение того PHP, который запустил Composer. Сайт может обслуживаться другим процессом и другой конфигурацией. Сравните версию, SAPI и загруженный ini в обоих местах, прежде чем менять зависимости или переключать все сайты сервера на новую версию.

SAPI — интерфейс, через который работает PHP: например, cli для консоли или fpm-fcgi для PHP-FPM. Даже одинаковая версия не означает одинаковый набор расширений. Для начала получите сведения из того же контейнера или сервера, где обслуживается проблемный запрос; локальная консоль разработчика здесь не является контрольным образцом.

Две колонки вместо одной команды php -v

СведениеС чем сопоставить
PHP_VERSIONверсия веб-процесса и требования проекта
PHP_SAPIконсоль, FPM или другой интерфейс
Загруженный php.iniкакой файл реально прочитан
Расширениянужные модули отдельно в CLI и web
Маршрут веб-серверас каким пулом или контейнером связан домен
# Команды чтения в окружении проекта
php -v
php --ini
php -m
composer check-platform-reqs

check-platform-reqs сравнивает реальную платформу с требованиями установленных пакетов и игнорирует подстановку config.platform. Но команду всё равно исполняет конкретный PHP в конкретном окружении. Если бинарников несколько, используйте явно выбранный путь к PHP и путь к composer.phar, предварительно проверенные на этом сервере. Не угадывайте имена пакетов и служб по примеру из другой панели.

Сведения веб-процесса получаем без публичного phpinfo

В защищённой диагностике приложения выведите только нужные значения: PHP_VERSION, PHP_SAPI, php_ini_loaded_file() и наличие требуемых расширений. Такой маршрут ограничивают администратором и удаляют после проверки. Не публикуйте полный phpinfo: он раскрывает лишние сведения об окружении. Непредсказуемое имя файла не является ограничением доступа.

PHP позволяет разные конфигурационные файлы для разных интерфейсов; фактически загруженный путь важнее ожидаемого пути в памятке. Сверьте также дополнительный каталог ini через принятую в проекте диагностику. Расширение может быть установлено в системе, но не загружено конкретным процессом. Ищите подтверждение в web-окружении, а не только строку в списке системных пакетов.

Меняем только тот участок, который расходится

  1. Сохранить требования проекта и сведения обоих окружений.
  2. Проверить связку домена с конкретным пулом или контейнером.
  3. Подготовить нужную версию и расширения в тестовом окружении.
  4. Проверить конфигурацию штатным средством этого сервиса.
  5. Переключить выбранный сайт и повторить его контрольный сценарий.

Если домен направлен в старый FPM-пул, редактирование консольного ini ничего не изменит. Если версия совпала, но отсутствует модуль, переключение версии целиком может добавить ненужный риск. Назовите одно расхождение и одно действие, которое его устраняет. На сервере с несколькими проектами общий рестарт или глобальная смена PHP затрагивает чужие требования.

Не подавляйте платформенные требования флагом ignore-platform-reqs ради зелёного запуска: это скрывает проверку, не устанавливая нужное расширение. Не выполняйте composer update как диагностическую попытку на рабочем сайте. Изменение набора зависимостей — отдельный релиз с проверкой lock-файла, а несовпадение PHP часто решается на уровне маршрутизации процесса.

Контроль проверяет сайт и фоновые команды

После переключения повторите web-сведения и контрольный запрос, который прежде падал. Затем отдельно проверьте cron и воркеры: они могут продолжать вызывать прежний CLI. Успешная главная страница не подтверждает обработку задач. Сохраните прежнюю связку пула и конфигурацию, чтобы вернуть её при регрессии, не меняя одновременно данные приложения.

Для помощи достаточно требований composer.json, версии CLI, версии web, SAPI и результатов проверки нужных модулей. Уберите секреты из конфигурации и не отправляйте полный дамп окружения. Такая таблица обычно показывает, где заканчивается проблема совместимости проекта и начинается выбор неправильного процесса на сервере.

Проверенные источники