Поиск
Ошибки

Ошибки Composer: как по сообщению найти причину

Composer ставит библиотеки PHP для сайта — например, для Laravel или Symfony. Когда что-то не так, он пишет сообщение на английском: что случилось и что он сделал. Найдите слова из своего сообщения в таблице ниже и откройте разбор — там по шагам, что делать.

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

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

  1. Найдите главную строку сообщения: она выделена красным фоном, а если в выводе есть блок Problem 1 — это строки под ним.
  2. Найдите слова из неё в таблице и откройте разбор.
  3. После исправления запустите ту же команду Composer снова, в папке проекта.

Найдите свою ошибку

Таблицы разбиты по тому, что случилось. Найдите слова из сообщения в левой колонке и откройте разбор.

Composer не подобрал версии

Слова в сообщенииЧто случилосьЧто делать
Your requirements could not be resolved to an installable set of packages.Composer не нашёл версии, которые подходят друг другу и серверуРазбор
requires php … -> your php version (…) does not satisfy that requirementбиблиотеке нужна другая версия PHPРазбор
requires ext-… -> it is missing from your systemна сервере нет модуля PHPРазбор
it has the wrong version installedмодуль PHP не той версииРазбор
found … but it does not match the constraintнет версии, которую просит composer.jsonРазбор
is locked to versionверсия закреплена в composer.lockРазбор

Composer не нашёл библиотеку

Слова в сообщенииЧто случилосьЧто делать
Could not find package … Did you mean this?опечатка в имени библиотекиРазбор
Could not find a matching version of packageнет ни библиотеки, ни похожих имёнРазбор
matching your minimum-stabilityу библиотеки только тестовые версииРазбор
it could not be found in any version, there may be a typo in the package name.в composer.json опечатка в имениРазбор
Installation failed, reverting ./composer.jsonComposer вернул файлы как былиРазбор

composer.json и composer.lock

Слова в сообщенииЧто случилосьЧто делать
The lock file is not up to date with the latest changes in composer.jsoncomposer.json поменяли после composer updateРазбор
Required package "…" is not present in the lock file.библиотеку дописали в composer.json вручнуюРазбор
Your lock file does not contain a compatible set of packages.версии из composer.lock не подходят серверуРазбор
No composer.lock file present.в проекте нет composer.lockРазбор
"./composer.json" does not contain valid JSONв composer.json ошибка записиРазбор
Composer could not find a composer.json file in …вы не в папке проектаРазбор

Установка и запуск

Слова в сообщенииЧто случилосьЧто делать
Do not run Composer as root/super user!Composer запущен через sudo или от rootРазбор
Allowed memory size of … bytes exhaustedComposer упёрся в лимит памятиРазбор
lack of memory or swap, or not having swap configuredпамяти не хватило серверуРазбор
The zip extension and unzip/7z commands are both missingнечем распаковать библиотекиРазбор
exceeded the timeout of 300 secondsкоманда не уложилась в 5 минутРазбор
Script … handling the … event returned with error codeкоманда из раздела scripts завершилась с ошибкойРазбор

Сайт после установки

Слова в сообщенииЧто случилосьЧто делать
Composer detected issues in your platformPHP сайта ниже, чем нужно библиотекамРазбор
Class "…" not foundPHP не нашёл класс библиотекиРазбор
Call to undefined functionне хватает модуля PHPРазбор

Если терминал отвечает, что команды composer нет, — Composer не установлен: как его установить.

Как читать сообщение Composer

Когда Composer не может подобрать версии библиотек, он пишет блок Problem:

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

  Problem 1
    - Root composer.json requires example/library ^2.0, found example/library[1.0.0, 1.1.0] but it does not match the constraint.
ЧастьЧто значит
Your requirements could not be resolved…итог: подобрать версии не вышло
Problem 1номер проблемы: их бывает несколько, решайте по одной
Root composer.json requires …что просит composer.json вашего проекта
example/library ^2.0имя библиотеки и какие версии подходят — как читать запись версии
текст после запятойпочему не подошло: здесь нашлись версии 1.0.0 и 1.1.0, а нужна 2.0 и новее — что там бывает

Другие ошибки Composer выделяет красным фоном. Над текстом бывает строка вида In ….php line …: — это место в коде Composer, для вас оно не важно.

Строки, которые начинаются с Warning:, — предупреждения: Composer продолжает работу. Строки со знаком > в начале — команды из раздела scripts в composer.json: их ошибки пишет не Composer, а сама команда — разбор.

Чтобы Composer написал подробнее, что он делает, добавьте к команде ключ -v: composer install -v.

Коды выхода Composer

Код — число, с которым Composer завершился. Узнать его можно сразу после команды: echo $? покажет код последней команды (echo). Код нужен, если Composer запускается из скрипта или по расписанию.

КодЧто значит
0всё прошло без ошибок
1ошибка — что случилось, написано в сообщении
2Composer не подобрал версии: в выводе блок Problem — разбор
3обновление одной библиотеки без composer.lock — разбор
4composer.lock не совпадает с composer.json или не ставится без изменений — разбор

Коды 2, 3 и 4 — у команд composer install, composer update и composer require.

Какая версия Composer

composer --version

В ответе — Composer version и номер версии. В Ubuntu 24.04 из пакета apt ставится Composer 2.7.1 — как установить.

Composer работает на той PHP, которую запускает команда php. Её версию покажет php -v. Сайт может работать на другой версии PHP — как это проверить.

Если Composer на виртуальном хостинге

Composer запускают в терминале, поэтому нужен вход по SSH. Есть ли на хостинге SSH и Composer, написано в панели или справке хостинга. Проверьте командой composer --version после входа по SSH.

Если SSH нет, библиотеки можно поставить на своём компьютере командой composer install и загрузить папку vendor на хостинг вместе с сайтом. Берите на компьютере ту же версию PHP, что у сайта: если библиотекам нужна PHP новее, чем у сайта, сайт ответит ошибкой 500 — Composer detected issues in your platform.

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

Источники

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

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

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