Поиск
Ошибки

Your requirements could not be resolved to an installable set of packages — что делать

Composer не смог подобрать версии библиотек так, чтобы все условия выполнились сразу, и ничего не поставил. Причина — в строке под «Problem 1»: какой пакет чего требует и почему это не выполняется. Найдите конец этой строки в таблице ниже — там сказано, что делать.

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

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

  1. Найдите под ошибкой строку Problem 1 и прочитайте строку под ней — она начинается с -.
  2. Найдите конец этой строки в таблице.
  3. Если задач несколько — 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.28.2 или новее, но не 9.0 и выше
^1.2.31.2.3 или новее, но не 2.0 и выше
~1.21.2 или новее, но не 2.0 и выше
~1.2.31.2.3 или новее, но не 1.3 и выше
>=7.47.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.

Источники

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

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

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