Ошибки Composer: как по сообщению найти причину
Composer ставит библиотеки PHP для сайта — например, для Laravel или Symfony. Когда что-то не так, он пишет сообщение на английском: что случилось и что он сделал. Найдите слова из своего сообщения в таблице ниже и откройте разбор — там по шагам, что делать.
Содержание 8
Что сделать прямо сейчас
- Найдите главную строку сообщения: она выделена красным фоном, а если в выводе есть блок
Problem 1— это строки под ним. - Найдите слова из неё в таблице и откройте разбор.
- После исправления запустите ту же команду 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.json | Composer вернул файлы как были | Разбор |
composer.json и composer.lock
| Слова в сообщении | Что случилось | Что делать |
|---|---|---|
The lock file is not up to date with the latest changes in composer.json | composer.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 exhausted | Composer упёрся в лимит памяти | Разбор |
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 platform | PHP сайта ниже, чем нужно библиотекам | Разбор |
Class "…" not found | PHP не нашёл класс библиотеки | Разбор |
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 | ошибка — что случилось, написано в сообщении |
| 2 | Composer не подобрал версии: в выводе блок Problem — разбор |
| 3 | обновление одной библиотеки без composer.lock — разбор |
| 4 | composer.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.
Источники
- Исходный код Composer 2.7.1 — на английском: тексты сообщений, коды выхода в Installer.php.
- Команды Composer — на английском: все команды и ключи.
- Пакет composer в Ubuntu 24.04 — версия Composer в Ubuntu 24.04.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Как установить Composer на Ubuntuустановка и первые команды.
- Как установить PHP на Ubuntuесли нужна другая версия PHP.
- Ошибки PHPвсе ошибки PHP на одной странице.
- Class not found в PHPесли сайт не находит класс библиотеки.
- 500 Internal Server Errorесли сайт не открывается.
- Ошибки Laravelесли после composer install не запускается проект Laravel.