Composer: your php version (…) does not satisfy that requirement — нужна другая версия PHP
Проекту или одной из его библиотек нужна другая версия PHP, чем та, с которой запущен Composer. Composer проверяет PHP командной строки — ту, что отвечает на команду php -v. Решение — запустить Composer с подходящей версией PHP или поставить версии библиотек, которые работают с вашей.
Содержание 11
Что сделать прямо сейчас
- Посмотрите, какую версию просят:
requires php ^8.2— нужна 8.2 или новее. Как читать запись — таблица. - Проверьте свою:
php -v. Первая строка начинается сPHPи номера версии. - Найдите свой случай: 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.
| Ubuntu | PHP из пакетов Ubuntu |
|---|---|
| 22.04 | 8.1.2 |
| 24.04 | 8.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 | проекту нужна другая PHP | PHP старее |
… 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 packages | composer.lock собран на другой PHP | Разбор |
после установки сайт отвечает 500 и пишет Composer detected issues in your platform | версия PHP сайта не подходит | Разбор |
Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код Composer 2.7.1 — на английском: сообщения в DependencyResolver/Problem.php и Rule.php.
- Настройки Composer — на английском: настройка platform.
- Пакет php8.3-cli в Ubuntu 24.04 — PHP 8.3.6 в Ubuntu 24.04.
- Пакет php8.1-cli в Ubuntu 22.04 — PHP 8.1.2 в Ubuntu 22.04.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Как установить PHP на UbuntuPHP-FPM и PHP командной строки.
- Composer detected issues in your platformесли сайт не открывается после установки.
- Ошибки Composerвсе ошибки Composer на одной странице.