Поиск
Ошибки

Composer: Could not find package — Composer не нашёл библиотеку

Composer не нашёл библиотеку с таким именем или не нашёл её версию, которая подходит проекту. Причины — опечатка в имени, у библиотеки есть только тестовые версии или её версии не подходят PHP на сервере. Composer подсказывает похожие имена: сверьте имя и запустите composer require снова.

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

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

  1. Сверьте имя библиотеки: оно из двух частей через косую черту — автор/библиотека, например example/library.
  2. Если Composer пишет Did you mean, возьмите имя из его списка и запустите composer require с ним.
  3. Если имя верное, найдите своё сообщение в таблице.

Как выглядит ошибка

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-beta1composer require example/library:^2.0@beta
только ветка dev-maincomposer 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».

Что сделать — по строке ниже:

Если пишет 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.jsonComposer вернул файлы как былиничего не менялось
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 года.

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

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