Composer detected issues in your platform — сайт не открывается после установки
Библиотекам сайта нужна PHP новее, чем та, на которой сайт работает. Composer проверяет это при каждом открытии сайта и, если версия ниже, останавливает его с ошибкой 500. Так бывает, если библиотеки ставили одной версией PHP, а сайт работает на другой. Решение — запустить сайт на нужной версии PHP или поставить библиотеки под PHP сервера.
Содержание 10
Что сделать прямо сейчас
- Посмотрите, какую версию просят:
require a PHP version ">= 8.2.0"— нужна 8.2 или новее. - Узнайте, на какой PHP работает сайт: версия PHP-FPM.
- Запустите сайт на нужной версии или поставьте библиотеки под PHP сервера — что выбрать.
Как выглядит ошибка
На странице сайта:
Composer detected issues in your platform:
Your Composer dependencies require a PHP version ">= 8.2.0".«Composer нашёл проблемы на вашей платформе: библиотекам нужна PHP 8.2.0 или новее». Сайт отвечает кодом 500, текст выше — всё, что видит посетитель.
В журнале ошибок nginx — та же надпись и версия PHP, на которой работает сайт:
… FastCGI sent in stderr: "PHP message: PHP Fatal error: Composer detected issues in your platform: Your Composer dependencies require a PHP version ">= 8.2.0". You are running 8.1.2-1ubuntu2.28. in /var/www/example.com/vendor/composer/platform_check.php on line …You are running 8.1.2-1ubuntu2.28 — сайт работает на PHP 8.1.2 из Ubuntu 22.04. На странице эту часть Composer не показывает. Как открыть журнал — где увидеть ошибку PHP.
Если запустить скрипт сайта из командной строки — например, php artisan в Laravel, — надпись появится прямо в окне SSH, вместе с You are running ….
Откуда эта проверка
Когда Composer ставит библиотеки, он кладёт в папку vendor файл vendor/composer/platform_check.php. Сайт подключает его при каждом открытии страницы — через vendor/autoload.php. В файле записана самая низкая версия PHP, с которой работают все библиотеки. Если PHP сайта ниже, проверка отвечает кодом 500 и останавливает PHP.
Проверяется только нижняя граница: если PHP новее, чем нужно библиотекам, проверка её пропустит.
Как такое бывает:
| Что сделали | Что случилось |
|---|---|
| ставили библиотеки на своём компьютере или на другом сервере и скопировали папку vendor | там PHP новее, чем у сайта |
запустили composer install с PHP 8.3, а сайт работает на PHP-FPM 8.1 | на сервере несколько версий PHP |
запустили Composer с ключом --ignore-platform-req=php или --ignore-platform-reqs | Composer не проверил версию PHP при установке |
| в панели хостинга поменяли версию PHP сайта на более старую | библиотеки остались прежние |
На какой PHP работает сайт
PHP сайта и PHP командной строки — разные программы, и версии у них могут не совпадать. Сравните.
PHP командной строки:
php -vPHP сайта — посмотрите строку fastcgi_pass в настройках сайта nginx:
grep -R fastcgi_pass /etc/nginx/sites-enabled/В ответе fastcgi_pass unix:/run/php/php8.1-fpm.sock; — сайт работает на PHP-FPM 8.1. Какие версии PHP-FPM есть на сервере, покажет ls /run/php/.
Что сделать
Если на сервере есть PHP-FPM нужной версии, переключите на неё сайт. В файле настроек сайта nginx замените в строке fastcgi_pass номер версии — например, php8.1-fpm.sock на php8.3-fpm.sock. Проверьте настройки и примените их:
sudo nginx -t
sudo systemctl reload nginxЕсли на новой версии PHP не хватает модулей, поставьте их — какой пакет нужен. Подробнее о PHP-FPM и nginx — Как установить PHP на Ubuntu.
Если нужной версии на сервере нет, проекту нужна PHP новее, чем есть в вашей Ubuntu. В Ubuntu 22.04 стоит PHP 8.1, в Ubuntu 24.04 — PHP 8.3. Варианты — переезд на новую Ubuntu или другая версия проекта.
Если библиотеки ставили с ключом --ignore-platform-req, поставьте их заново без него, той же PHP, на которой работает сайт:
cd /var/www/example.com
composer installЕсли Composer остановится с ошибкой про версию PHP, — разбор.
Если сообщение про модули
Composer detected issues in your platform:
Your Composer dependencies require the following PHP extensions to be installed: gd, zip.«Библиотекам нужны модули PHP gd и zip». Такую проверку Composer добавляет, только если в composer.json включена настройка platform-check со значением true: по умолчанию он проверяет только версию PHP. Поставьте модули для PHP сайта и перезапустите PHP-FPM — как поставить модуль.
Почему не стоит выключать проверку
Проверку можно выключить настройкой platform-check со значением false — тогда Composer не будет создавать файл platform_check.php. Сайт откроется, но библиотеки написаны для более новой PHP, и PHP остановится на первой же строке, которую не понимает, — с ошибкой, по которой причину найти труднее. Проверка показывает причину сразу.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Composer detected issues in your platform и ответ 500 | PHP сайта ниже, чем нужно библиотекам | сравните версии |
require a PHP version ">= …". You are running … в журнале | та же причина, в журнале видна версия сайта | переключите сайт на нужную PHP |
php -v показывает 8.3, а в fastcgi_pass — 8.1 | сайт и командная строка на разных версиях | поменяйте fastcgi_pass |
require the following PHP extensions to be installed | модулей нет у PHP сайта | поставьте модули |
composer install пишет your php version (…) does not satisfy | на сервере старая PHP | Разбор |
| пустая страница или 500 без этой надписи | другая ошибка PHP | 500 Internal Server Error |
Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код Composer 2.7.1 — на английском: как создаётся platform_check.php, в Autoload/AutoloadGenerator.php.
- Настройки Composer — на английском: настройка platform-check и значение php-only по умолчанию.
- Пакет php8.1-cli в Ubuntu 22.04 — PHP 8.1.2 в Ubuntu 22.04.
- Пакет php8.3-cli в Ubuntu 24.04 — PHP 8.3.6 в Ubuntu 24.04.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки PHPгде журнал и как читать сообщения PHP.
- Your php version does not satisfy that requirementесли проекту нужна PHP новее.
- Ошибки Composerвсе ошибки Composer на одной странице.