Интерфейс и команды командной строки Composer (часть 4)

Вступление

Это четвертая часть интерфейса командной строки Composer и команд.

# устаревший

Команда «compose outdated» - это команда composer, используемая для отображения списка текущей версии установленных пакетов, а также их последней версии, если она доступна. Эта команда аналогична команде « composer show -lo» .

Эти устаревшие пакеты отображаются со следующими цветовыми кодами:

• зеленый (=) : это означает, что зависимость находится в последней версии и обновлена.
• желтый (~) : это означает, что у зависимости есть новая доступная версия, которая включает разрывы обратной совместимости в соответствии с semver, поэтому обновление осуществляется на ваш страх и риск, так как может потребоваться много работ.
• красный (!) : это очень важно, это указывает на то, что у зависимости есть новая версия, которая совместима с полуверсией, и вам рекомендуется обновить ее.

Опции

• --all (-a): с этим флагом будут отображаться все установленные пакеты, а не только устаревшие.
• --direct (-D): отображает только те пакеты, которые являются нашими прямыми зависимостями.
• --strict: Это приведет к возврату ненулевого кода завершения, если какой-либо пакет устарел.
• --minor-only (-m): отображает пакеты с незначительными совместимыми с SemVer обновлениями.
• --format (-f): это форматер вывода, он позволяет нам выбирать между выводом json и текста

#browse / home

Обзор (также называемый home) открывает URL-адрес хранилища пакета или домашнюю страницу в нашем браузере. Некоторые необязательные параметры также могут быть использованы с этой командой

Опции

• --homepage (-H): открывает домашнюю страницу вместо URL хранилища.
• --show (-s): показывает только URL домашней страницы или хранилища, если доступно.

#suggests

Перечисляет все предлагаемые пакеты по текущим установленным пакетам. Мы можем передать необязательное имя пакета, чтобы отформатировать и ограничить вывод только именами пакетов. Название должно быть в следующем формате: «продавец / пакеты».

Мы можем использовать флаги --by-package или --by-Suggestion, чтобы сгруппировать выходные данные по пакетам, предлагающим предложения или предлагаемые пакеты соответственно.

Кроме того, флаг --verbose (-v) используется для отображения предлагаемого пакета и причины предложения. Следовательно, это означает, что --by-package --by-Suggestion будет отображать оба списка.

composer suggests vendor_name/package_name  --by-package –-by suggestion

Команда предложить также может быть объединена с некоторыми дополнительными параметрами, как показано:

Опции

• --by-package: группирует вывод по предлагаемым пакетам.
• --by-Suggestion: также группирует вывод по предлагаемому пакету.
• --no-dev: это исключит предложения из пакетов require-dev .

# зависит (почему)

Композитор зависит от команды, которая сообщает нам, какие пакеты зависят от определенного другого пакета.

composer depends doctrine/lexer

Приведенный выше фрагмент кода отобразит все пакеты, от которых зависит « doctrine / lexer ».

Мы также можем дополнительно указать ограничение версии после пакета, чтобы ограничить результаты поиска.

Добавление флага --tree или -t, чтобы показать рекурсивное дерево того, почему этот пакет зависит от определенного пакета.

composer depends doctrine/lexer -t

Некоторые необязательные параметры также могут быть переданы в композитор в зависимости от команды, как показано ниже

• --recursive (-r): эта команда разрешает рекурсивно, разрешает до корневого пакета.
• --tree (-t): это гнездится, печатая, почему пакет зависит от другого.

# запрещает (почему-нет)

Команда composer prohibits сообщает нам, какие пакеты препятствуют установке данного пакета.

composer prohibits symfony/symfony 3.1 

Мы можем указать ограничение версии, чтобы проверить, можно ли выполнять обновления в проекте, а если нет, то почему.

Примечание: мы также можем указать требования к платформе, например, узнать требования к платформе, чтобы проверить, можно ли обновить сервер до PHP 8.0, скажем так.

composer prohibits prohibits php:8

Используя команду зависимости, мы можем выполнить рекурсивный поиск, который отобразит все пакеты в зависимости от пакетов, вызывающих конфликт, некоторые необязательные параметры также могут быть переданы, как показано

Опции

• --recursive (-r): рекурсивно разрешает до корневого пакета.
• --tree (-t): выводит результаты в виде вложенного дерева, подразумевает -r.

#validate

Команда composer validate используется для проверки правильности файлов composer.json. Настоятельно рекомендуется удалить эту командную оболочку до того, как мы передадим файл composer.json.

composer validate

Некоторые необязательные флаги могут быть переданы команде проверки композитора, как показано ниже:

Опции

• --no-check-all: этот флаг заставит композитора не выдавать предупреждение, если требования в composer.json не выполнены, а использовать несвязанные ограничения версии.
• --no-check-lock: Это не вызовет выдачи ошибок, если composer.lock существует и не обновлен.
• --no-check-publish: Этот флаг также предотвращает выдачу ошибки, если composer.json не подходит для публикации в качестве пакета на Packagist, но в других случаях допустим.
• --with-dependencies: это проверит файл composer.json, а также composer.json всех установленных зависимостей.
• --strict: это вернет ненулевой код завершения для всех предупреждений, а также ошибок.

Предыдущая: Интерфейс и команды командной строки Composer (часть 3)
Далее: Интерфейс командной строки Composer и команды (часть 5)