Your requirements could not be resolved to an installable set of packages — что делать
Composer не смог подобрать версии библиотек так, чтобы все условия выполнились сразу, и ничего не поставил. Причина — в строке под «Problem 1»: какой пакет чего требует и почему это не выполняется. Найдите конец этой строки в таблице ниже — там сказано, что делать.
Содержание 11
Что сделать прямо сейчас
- Найдите под ошибкой строку
Problem 1и прочитайте строку под ней — она начинается с-. - Найдите конец этой строки в таблице.
- Если задач несколько —
Problem 2,Problem 3, — исправляйте их по очереди, начиная с первой, и после каждой запускайте команду снова.
Как выглядит ошибка
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 перебрал версии библиотек и не нашёл такого набора, при котором выполнены все условия: из вашего composer.json, из файлов самих библиотек и от PHP на сервере.
Под Problem 1 — одна задача, которую Composer не смог решить. При такой ошибке Composer ничего не скачивает и не меняет в папке vendor и в composer.lock. Код выхода — 2: его видно в скрипте или в cron.
Как читать строку
Строка бывает двух видов.
Условие из вашего composer.json:
- Root composer.json requires php ^8.2 but your php version (8.1.2) does not satisfy that requirement.Root composer.json — главный файл composer.json вашего проекта. requires php ^8.2 — «требует PHP ^8.2». После but — почему условие не выполнено: у вас PHP 8.1.2.
Условие библиотеки:
- laravel/framework v11.0.0 requires php ^8.2 -> your php version (8.1.2) does not satisfy that requirement.laravel/framework v11.0.0 — библиотека и её версия, requires php ^8.2 — что ей нужно, а после стрелки -> — почему это не выполнено. Исправлять надо то, что написано после стрелки.
Как читать запись версии
| Запись | Что значит |
|---|---|
^8.2 | 8.2 или новее, но не 9.0 и выше |
^1.2.3 | 1.2.3 или новее, но не 2.0 и выше |
~1.2 | 1.2 или новее, но не 2.0 и выше |
~1.2.3 | 1.2.3 или новее, но не 1.3 и выше |
>=7.4 | 7.4 или новее |
* | любая версия |
2.1.0 | ровно 2.1.0 |
Что написано в строке под Problem
| Конец строки | Что случилось | Что делать |
|---|---|---|
your php version (…) does not satisfy that requirement. | PHP на сервере старее, чем нужно проекту или библиотеке | Разбор |
it is missing from your system. Install or enable PHP's … extension. | не поставлен или выключен модуль PHP | Разбор |
it has the wrong version installed (…) | модуль PHP есть, но не той версии | Разбор |
it could not be found in any version, there may be a typo in the package name. | пакета с таким именем нет | Разбор |
found … but it does not match the constraint. | пакет есть, но ни одна его версия не подходит под условие | условие версии |
does not match your minimum-stability. | у пакета есть только тестовые версии | Разбор |
is locked to version … and an update of this package was not requested. | версия пакета закреплена в composer.lock | -W |
conflicts with … | два пакета не работают вместе | конфликт |
Если не подходит ни одна версия
Problem 1
- Root composer.json requires example/library ^4.0, found example/library[1.0.0, ..., 2.4.0] but it does not match the constraint.Здесь example/library — пример имени. В квадратных скобках — какие версии пакета есть: от 1.0.0 до 2.4.0. Условие ^4.0 требует версию 4 и выше, а такой нет.
Что сделать: укажите версию, которая есть. Если пакет добавляли командой composer require, повторите её с подходящей версией:
composer require example/library:^2.4Если условие записано в composer.json вручную, поправьте его там и запустите composer update example/library. Как Composer меняет файлы при require — разбор.
Если версия закреплена в composer.lock
Problem 1
- example/library is locked to version 1.2.0 and an update of this package was not requested.«Пакет закреплён на версии 1.2.0, а обновлять его не просили». Когда вы ставите новую библиотеку командой composer require или обновляете одну командой composer update имя/пакета, остальные библиотеки остаются на версиях из composer.lock. Если новой библиотеке нужна другая версия закреплённой, Composer останавливается и под задачами пишет подсказку:
Use the option --with-all-dependencies (-W) to allow upgrades, downgrades and removals for packages currently locked to specific versions.«Добавьте ключ -W, чтобы разрешить обновлять, понижать и удалять закреплённые пакеты». Повторите ту же команду с -W:
composer require example/new:^2.0 -WС этим ключом Composer может поменять версии и других библиотек. Посмотрите список изменений в выводе команды и проверьте сайт после неё.
Если пакеты конфликтуют
Строка с conflicts with значит, что в файле одного пакета прямо записано: с другим пакетом или с какими-то его версиями он не работает. Что сделать:
- обновите второй пакет до версии, с которой конфликта нет:
composer update имя/второго-пакета -W; - или выберите другую версию первого пакета — подходящую указывают в описании пакета или в его списке изменений.
Если ошибка при composer install
composer install ставит точные версии из composer.lock. Если они не подходят к серверу, сообщение будет другим — Your lock file does not contain a compatible set of packages. Please run composer update. Разбор — файл блокировки.
Проверить заранее, хватает ли проекту версии PHP и модулей на сервере:
composer check-platform-reqsОшибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
requires php … your php version (…) does not satisfy | старая версия PHP | Разбор |
requires ext-… it is missing from your system | нет модуля PHP | Разбор |
could not be found in any version | опечатка в имени пакета | Разбор |
found … but it does not match the constraint | нет нужной версии | укажите версию из списка |
is locked to version и подсказка про -W | версия закреплена в composer.lock | повторите команду с -W |
Your lock file does not contain a compatible set of packages | версии из composer.lock не подходят серверу | Разбор |
Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код Composer 2.7.1 — на английском: сообщения в Installer.php, DependencyResolver/Problem.php, Rule.php и SolverProblemsException.php.
- Версии и условия в Composer — на английском: что значат записи ^ и ~.
- Команды Composer — на английском: require, update, ключ --with-all-dependencies.
- Пакет composer в Ubuntu 24.04 — версия Composer в Ubuntu 24.04.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Your php version does not satisfy that requirementесли проекту нужна PHP новее.
- Как установить Composer на Ubuntuустановка и основные команды.
- Ошибки Composerвсе ошибки Composer на одной странице.