Поиск
Ошибки

Composer: your php version (…) does not satisfy that requirement — нужна другая версия PHP

Проекту или одной из его библиотек нужна другая версия PHP, чем та, с которой запущен Composer. Composer проверяет PHP командной строки — ту, что отвечает на команду php -v. Решение — запустить Composer с подходящей версией PHP или поставить версии библиотек, которые работают с вашей.

≈ 7 мин чтения
Содержание 11

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

  1. Посмотрите, какую версию просят: requires php ^8.2 — нужна 8.2 или новее. Как читать запись — таблица.
  2. Проверьте свою: php -v. Первая строка начинается с PHP и номера версии.
  3. Найдите свой случай: PHP старее, PHP новее, на сервере несколько версий.

Как выглядит ошибка

Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Root composer.json requires php ^8.2 but your php version (8.1.2) does not satisfy that requirement.

«Главный composer.json требует PHP ^8.2, а ваша версия PHP 8.1.2 этому условию не отвечает». Так написано, если версию PHP требует сам проект.

Если её требует библиотека, строка другая:

    - laravel/framework v11.0.0 requires php ^8.2 -> your php version (8.1.2) does not satisfy that requirement.

Здесь версия 11.0.0 библиотеки Laravel требует PHP 8.2 или новее. Если не подошли сразу несколько версий библиотеки, Composer собирает их в одну строку: после имени в квадратных скобках — список версий, а вместо requires — require:

    - example/library[2.0.0, ..., 2.5.0] require php ^8.2 -> your php version (8.1.2) does not satisfy that requirement.

Здесь example/library — пример имени: ни одна из версий от 2.0.0 до 2.5.0 не работает с PHP 8.1.2.

Какую PHP проверяет Composer

Composer — программа на PHP. Он проверяет ту версию PHP, которой его запустили, — PHP для командной строки. Её показывает команда:

php -v

Сайт может работать на другой версии: PHP-FPM для сайта и PHP командной строки — разные программы. Какие версии PHP-FPM есть на сервере, покажет ls /run/php/: файл php8.3-fpm.sock — работает PHP-FPM 8.3.

UbuntuPHP из пакетов Ubuntu
22.048.1.2
24.048.3.6

Свою версию Ubuntu покажет lsb_release -a — подробнее.

Если PHP на сервере старее

Пример: проекту нужна ^8.2, а на сервере Ubuntu 22.04 с PHP 8.1.2. В пакетах Ubuntu 22.04 PHP 8.2 и новее нет. Варианты:

  • Переехать на Ubuntu 24.04 — в ней PHP 8.3.6. Надёжнее поднять новый сервер с Ubuntu 24.04 и перенести на него сайт: как настроить VPS, как перенести сайт. Обновить систему на месте тоже можно — как перейти на новую версию Ubuntu.
  • Поставить версию проекта, которая работает с вашей PHP. Если версию PHP требует библиотека, у неё может быть более старая версия для PHP 8.1. Какую выбрать, решает разработчик сайта: смена основной версии библиотеки может поменять работу сайта.

Если PHP новее, чем нужно библиотеке

    - example/library 1.4.0 requires php ^7.4 -> your php version (8.3.6) does not satisfy that requirement.

Здесь example/library — пример имени. ^7.4 значит 7.4 или новее, но не 8.0 и выше: библиотека старая и с PHP 8 не работает. Так бывает после переезда на Ubuntu 24.04.

Что сделать: обновите библиотеку до версии, которая работает с PHP 8:

composer update example/library -W

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

Перед обновлением библиотек на рабочем сайте сделайте копию папки проекта и базы — резервные копии.

Если на сервере несколько версий PHP

Посмотрите, какие версии стоят:

ls /etc/php/

В ответе — папки с номерами версий, например 8.1 8.3. Команда php запускает одну из них, а Composer можно запустить с нужной:

php8.3 /usr/bin/composer install

/usr/bin/composer — путь к Composer из пакета Ubuntu. Если ставили Composer по-другому, путь покажет which composer. Сайт должен работать на той же версии PHP-FPM, иначе после установки он может не открыться — Composer detected issues in your platform.

Если composer.lock собран на другой PHP

Если composer.lock создали на компьютере с PHP новее, чем на сервере, composer install на сервере остановится: Your lock file does not contain a compatible set of packages. Разбор — файл блокировки.

Разработчик может указать Composer версию PHP сервера — тогда Composer будет подбирать библиотеки под неё, на каком бы компьютере ни работал:

composer config platform.php 8.1.2
composer update

Первая команда записывает настройку platform в composer.json, вторая подбирает версии заново и переписывает composer.lock.

Почему не стоит пропускать проверку

Ключ --ignore-platform-req=php велит Composer не проверять версию PHP. Библиотеки поставятся, но они написаны для другой версии PHP, и сайт будет падать с ошибками. Кроме того, Composer кладёт в vendor проверку версии, и сайт сразу ответит ошибкой 500 — Composer detected issues in your platform.

Ошибки и как их исправить

Что видитеПричинаЧто делать
Root composer.json requires php … does not satisfyпроекту нужна другая PHPPHP старее
… requires php ^8.2 -> your php version (8.1.2)библиотеке нужна PHP новеепереезд или другая версия
… requires php ^7.4 -> your php version (8.3.6)библиотека стараяcomposer update имя -W
php -v показывает одну версию, а сайт работает на другойна сервере несколько версий PHPзапустите Composer с нужной
Your lock file does not contain a compatible set of packagescomposer.lock собран на другой PHPРазбор
после установки сайт отвечает 500 и пишет Composer detected issues in your platformверсия PHP сайта не подходитРазбор

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

Источники

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

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

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