Поиск
Ошибки

Composer detected issues in your platform — сайт не открывается после установки

Библиотекам сайта нужна PHP новее, чем та, на которой сайт работает. Composer проверяет это при каждом открытии сайта и, если версия ниже, останавливает его с ошибкой 500. Так бывает, если библиотеки ставили одной версией PHP, а сайт работает на другой. Решение — запустить сайт на нужной версии PHP или поставить библиотеки под PHP сервера.

≈ 6 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Посмотрите, какую версию просят: require a PHP version ">= 8.2.0" — нужна 8.2 или новее.
  2. Узнайте, на какой PHP работает сайт: версия PHP-FPM.
  3. Запустите сайт на нужной версии или поставьте библиотеки под 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-reqsComposer не проверил версию PHP при установке
в панели хостинга поменяли версию PHP сайта на более старуюбиблиотеки остались прежние

На какой PHP работает сайт

PHP сайта и PHP командной строки — разные программы, и версии у них могут не совпадать. Сравните.

PHP командной строки:

php -v

PHP сайта — посмотрите строку 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 и ответ 500PHP сайта ниже, чем нужно библиотекамсравните версии
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 без этой надписидругая ошибка PHP500 Internal Server Error

Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.

Источники

Сверено 13 ноября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше