Успешный 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-reqscheck-platform-reqs сравнивает реальную платформу с требованиями установленных пакетов и игнорирует подстановку config.platform. Но команду всё равно исполняет конкретный PHP в конкретном окружении. Если бинарников несколько, используйте явно выбранный путь к PHP и путь к composer.phar, предварительно проверенные на этом сервере. Не угадывайте имена пакетов и служб по примеру из другой панели.
Сведения веб-процесса получаем без публичного phpinfo
В защищённой диагностике приложения выведите только нужные значения: PHP_VERSION, PHP_SAPI, php_ini_loaded_file() и наличие требуемых расширений. Такой маршрут ограничивают администратором и удаляют после проверки. Не публикуйте полный phpinfo: он раскрывает лишние сведения об окружении. Непредсказуемое имя файла не является ограничением доступа.
PHP позволяет разные конфигурационные файлы для разных интерфейсов; фактически загруженный путь важнее ожидаемого пути в памятке. Сверьте также дополнительный каталог ini через принятую в проекте диагностику. Расширение может быть установлено в системе, но не загружено конкретным процессом. Ищите подтверждение в web-окружении, а не только строку в списке системных пакетов.
Меняем только тот участок, который расходится
- Сохранить требования проекта и сведения обоих окружений.
- Проверить связку домена с конкретным пулом или контейнером.
- Подготовить нужную версию и расширения в тестовом окружении.
- Проверить конфигурацию штатным средством этого сервиса.
- Переключить выбранный сайт и повторить его контрольный сценарий.
Если домен направлен в старый FPM-пул, редактирование консольного ini ничего не изменит. Если версия совпала, но отсутствует модуль, переключение версии целиком может добавить ненужный риск. Назовите одно расхождение и одно действие, которое его устраняет. На сервере с несколькими проектами общий рестарт или глобальная смена PHP затрагивает чужие требования.
Не подавляйте платформенные требования флагом ignore-platform-reqs ради зелёного запуска: это скрывает проверку, не устанавливая нужное расширение. Не выполняйте composer update как диагностическую попытку на рабочем сайте. Изменение набора зависимостей — отдельный релиз с проверкой lock-файла, а несовпадение PHP часто решается на уровне маршрутизации процесса.
Контроль проверяет сайт и фоновые команды
После переключения повторите web-сведения и контрольный запрос, который прежде падал. Затем отдельно проверьте cron и воркеры: они могут продолжать вызывать прежний CLI. Успешная главная страница не подтверждает обработку задач. Сохраните прежнюю связку пула и конфигурацию, чтобы вернуть её при регрессии, не меняя одновременно данные приложения.
Для помощи достаточно требований composer.json, версии CLI, версии web, SAPI и результатов проверки нужных модулей. Уберите секреты из конфигурации и не отправляйте полный дамп окружения. Такая таблица обычно показывает, где заканчивается проблема совместимости проекта и начинается выбор неправильного процесса на сервере.