Composer: Could not find package — Composer не нашёл библиотеку
Composer не нашёл библиотеку с таким именем или не нашёл её версию, которая подходит проекту. Причины — опечатка в имени, у библиотеки есть только тестовые версии или её версии не подходят PHP на сервере. Composer подсказывает похожие имена: сверьте имя и запустите composer require снова.
Содержание 12
- Что сделать прямо сейчас
- Как выглядит ошибка
- Как проверить имя
- Если Composer не находит версию
- Если есть только тестовые версии
- Если ветку переименовали
- Если версии не подходят PHP на сервере
- Если пишет could not be found in any version
- Что Composer сделал с файлами
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Сверьте имя библиотеки: оно из двух частей через косую черту —
автор/библиотека, напримерexample/library. - Если Composer пишет
Did you mean, возьмите имя из его списка и запуститеcomposer requireс ним. - Если имя верное, найдите своё сообщение в таблице.
Как выглядит ошибка
Could not find package example/librray.
Did you mean this?
example/libraryЗдесь example/librray — пример имени с опечаткой. «Пакет example/librray не найден. Может быть, вы имели в виду этот?» Ниже — до пяти похожих имён. Если похожих несколько, Composer пишет Did you mean one of these? — «может быть, один из этих?».
Так бывает при composer require example/library без версии: Composer ищет библиотеку и подбирает версию до того, как что-то менять. Если вы набрали команду сами в окне терминала, Composer спросит:
Could not find package example/librray.
Pick one of these or leave empty to abort:«Выберите одно из имён или оставьте пустым, чтобы отменить». Ниже — список имён с номерами в квадратных скобках. Введите номер нужного и нажмите Enter — Composer продолжит с ним. Просто Enter — отмена.
Как проверить имя
- Имя пишется латиницей: буквы, цифры и знаки
_,.,/,-. Пробелов и других знаков в нём нет. - Возьмите имя со страницы библиотеки на сайте packagist.org — это каталог, откуда Composer берёт библиотеки. На странице есть готовая команда
composer require …: скопируйте её целиком. - Найти библиотеку по слову можно командой
composer search:
composer search libraryВ ответе — имена библиотек и их описания.
Если Composer не находит версию
Could not find a matching version of package example/library. Check the package spelling, your version constraint and that the package is available in a stability which matches your minimum-stability (stable).«Не найдена подходящая версия пакета. Проверьте имя, условие версии и что у пакета есть версия со стабильностью не ниже minimum-stability (stable)». Composer пишет это, когда не нашёл ни библиотеку, ни похожих имён.
Что сделать:
- Проверьте имя — как это сделать.
- Запускайте Composer в папке проекта. Если библиотека не из Packagist — например, из закрытого репозитория разработчика, — её адрес записан в разделе
repositoriesв composer.json проекта. В другой папке Composer её не найдёт.
Если есть только тестовые версии
Could not find a version of package example/library matching your minimum-stability (stable). Require it with an explicit version constraint allowing its desired stability.«Нет версии пакета с нужной стабильностью — minimum-stability (stable). Укажите версию явно, с её стабильностью». Библиотека есть, но у неё только тестовые версии.
Стабильность версий в Composer:
| Стабильность | Что это | Как выглядит версия |
|---|---|---|
| stable | готовая версия | 2.0.0 |
| RC, beta, alpha | тестовые версии | 2.0.0-RC1, 2.0.0-beta1, 2.0.0-alpha1 |
| dev | код из ветки, который ещё дописывают | dev-main |
Настройка minimum-stability в composer.json — с какой стабильности Composer берёт версии. Если её нет, это stable: Composer ставит только готовые версии.
Какие версии есть у библиотеки, покажет команда — смотрите строку versions ::
composer show --all example/libraryУкажите версию со стабильностью только для этой библиотеки:
| Какие версии есть | Команда |
|---|---|
бета-версии, например 2.0.0-beta1 | composer require example/library:^2.0@beta |
только ветка dev-main | composer require example/library:dev-main |
@beta после версии — «для этой библиотеки бери и бета-версии». Для остальных библиотек Composer по-прежнему берёт готовые версии.
Если такая версия уже записана в composer.json, а Composer подбирает версии при composer install или composer update, в блоке Problem будет:
- Root composer.json requires example/library ^2.0, found example/library[…] but it does not match your minimum-stability.«composer.json проекта требует example/library ^2.0; пакет найден, но его версии ниже minimum-stability». Допишите стабильность в composer.json — "example/library": "^2.0@beta" — и запустите composer update example/library.
Если ветку переименовали
- Root composer.json requires example/library dev-master, found example/library[dev-main] but it does not match the constraint. Perhaps dev-master was renamed to dev-main?«composer.json требует ветку dev-master, а у библиотеки есть dev-main. Может быть, master переименовали в main?» Замените в composer.json dev-master на dev-main и запустите composer update example/library.
Если версии не подходят PHP на сервере
Package example/library has requirements incompatible with your PHP version, PHP extensions and Composer version:
- example/library 3.0.0 requires php >=8.4 which does not match your installed version 8.3.6.Здесь версии — пример. «Требования пакета не подходят вашей версии PHP, модулям PHP и версии Composer: example/library 3.0.0 требует PHP 8.4 и новее, а у вас 8.3.6». Похожее сообщение — Could not find package example/library in any version matching your PHP version, PHP extensions and Composer version: «ни одна версия пакета не подходит вашей PHP, модулям и Composer».
Что сделать — по строке ниже:
requires php … which does not match your installed version— библиотеке нужна PHP новее: разбор.requires ext-… but it is not present.— на сервере нет модуля PHP: какой пакет поставить.
Если пишет could not be found in any version
При composer install и composer update Composer пишет об этом в блоке Problem:
Problem 1
- Root composer.json requires example/librray, it could not be found in any version, there may be a typo in the package name.«composer.json проекта требует example/librray, а такого пакета нет ни в одной версии. Возможно, опечатка в имени». Имя записано в composer.json — исправьте его там и запустите composer update example/library. Как читать блок Problem — разбор.
Если в имени недопустимый знак, строка другая:
- Root composer.json requires …, it could not be found, it looks like its name is invalid, "…" is not allowed in package names.«Пакет не найден, похоже, имя неправильное: знаки "…" в именах пакетов не разрешены». В кавычках — знаки, которых в имени быть не может, например пробел или двоеточие. Уберите их из имени в composer.json.
Если composer require без версии не смог подобрать версии, под блоком Problem Composer подсказывает:
You can also try re-running composer require with an explicit version constraint, e.g. "composer require example/library:*" to figure out if any version is installable, or "composer require example/library:^2.1" if you know which you need.«Попробуйте указать версию явно: composer require example/library:* — чтобы узнать, ставится ли хоть одна версия, или composer require example/library:^2.1, если знаете, какая нужна».
Что Composer сделал с файлами
composer require сначала дописывает библиотеку в composer.json, потом ставит её. Если поставить не вышло, Composer пишет:
Installation failed, reverting ./composer.json and ./composer.lock to their original content.«Установка не удалась, composer.json и composer.lock возвращены как были». Composer сам вернул файлы: библиотека не добавлена, исправлять в них ничего не нужно. Если composer.lock в проекте нет, строка такая: Installation failed, reverting ./composer.json to its original content.
Если ошибка в блоке Problem — Composer не подобрал версии, — папку vendor он не трогал.
Если в папке не было composer.json, Composer создаёт его для команды, а после ошибки удаляет:
Installation failed, deleting ./composer.json.«Установка не удалась, ./composer.json удалён». Composer удаляет и composer.lock, если успел его создать. Рядом бывает строка No composer.json present in the current directory (./composer.json), this may be the cause of the following exception. — «в текущей папке нет composer.json, возможно, причина в этом». Так бывает, если вы не в папке проекта: перейдите в неё и запустите команду снова.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Could not find package … Did you mean this? | опечатка в имени | возьмите имя из списка |
Could not find a matching version of package | нет ни библиотеки, ни похожих имён | проверьте имя и папку |
Could not find a version of package … matching your minimum-stability | у библиотеки только тестовые версии | укажите стабильность |
but it does not match your minimum-stability. | версии ниже minimum-stability | допишите @beta или @dev |
Perhaps dev-master was renamed to dev-main? | ветку переименовали | замените на dev-main |
has requirements incompatible with your PHP version, PHP extensions and Composer version | версии не подходят PHP или модулям | смотрите строку ниже |
it could not be found in any version, there may be a typo in the package name. | в composer.json опечатка в имени | исправьте имя |
it looks like its name is invalid | недопустимый знак в имени | уберите знак |
Installation failed, reverting ./composer.json | Composer вернул файлы как были | ничего не менялось |
Installation failed, deleting ./composer.json. | вы не в папке проекта | перейдите в папку проекта |
Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код Composer 2.7.1 — на английском: поиск пакета и версии в Command/PackageDiscoveryTrait.php, возврат файлов в Command/RequireCommand.php, строки блока Problem в DependencyResolver/Problem.php.
- Описание composer.json — на английском: настройка minimum-stability и флаги стабильности вида @beta.
- Команды Composer — на английском: require, search и show.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Your requirements could not be resolvedкак читать блок Problem.
- Your php version does not satisfy that requirementесли библиотеке нужна PHP новее.
- Ошибки Composerвсе ошибки Composer на одной странице.