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

Вступление

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

#статус

Команда status позволяет нам проверять локальные изменения в исходных кодах наших зависимостей. Это часто используется в сценариях, где исходные коды часто модифицируются.

composer status

Используя флаг команды --verbose, мы можем получить некоторую дополнительную информацию о том, что было изменено в исходном коде.

composer status --verbose

# самообновление (selfupdate)

Это используется для обновления или обновления нашего композитора до последней версии. Просто запустите команду самообновления composer, и файл composer.phar будет заменен новой версией файла composer.phar .

composer self-update

Мы можем обновить конкретный пакет, включив имя пакета в команду «самообновления», как показано ниже:

composer self-update 1.0.0-alpha7

Если Composer был установлен глобально, мы могли бы обновить его, используя команду « sudo», как показано в приведенной ниже команде:

sudo -H composer self-update

Другие необязательные параметры также могут быть переданы «команде самообновления»:

• --rollback (-r): откатывает компоновщик до последней установленной версии, восстанавливая некоторые настройки и конфигурации по умолчанию.
• --clean-backups : обновляет композитор, а также удаляет все предыдущие доступные резервные копии.
• --no-progress: загрузка и обновление композитора без отображения прогресса загрузки
• --update-keys: используется для запроса пользователя на обновление ключа.
• --stable: команда обновления на стабильном канале.
• --preview: Требовать обновления на канале предварительного просмотра.
• --snapshot: эта команда принудительно обновляет канал снимка.

#config

Команда config позволяет нам редактировать настройки конфигурации композитора в локальном или глобальном файле config.json

Это также позволяет редактировать большинство свойств в локальном файле composer.json .

composer config --list

#Использование:

Параметры конфигурации также могут использоваться в следующем формате:

config [опции] [ключ-настройки] [значение-настройки1] ... [значение-установкиN]

ключ-настройки - это имя параметра конфигурации, а параметр-значение1 - это значение конфигурации. Для параметров, которые могут принимать массив значений (например, github-protocol ), допускается более одного аргумента значения параметра.

Мы также можем редактировать значения следующих свойств:

описание, домашняя страница, ключевые слова, лицензия, минимальная стабильность, имя, предпочтительная стабильность, тип и версия .

Конфигурация композитора имеет следующие необязательные параметры:

• --global (-g): по умолчанию работает с глобальным конфигурационным файлом, расположенным в « $ COMPOSER_HOME / config.json ». Если этот флаг не указан, это влияет на локальный файл composer.json или файл, указанный в « --file» .
• --editor (-e): он открывает локальный файл composer.json, используя текстовый редактор, как это определено переменной EDITOR env. Когда указана опция --global , открывается глобальный файл конфигурации.
• --auth (-a): используется, чтобы повлиять на изменения в конфигурационном файле auth (используется только для --editor).
• --unset: удаляет элемент конфигурации, названный установочным ключом .
• --list (-l): показывает список текущих переменных конфигурации. С опцией --global это перечисляет только глобальную конфигурацию.
• --file = "..." (-f): работать с определенным файлом вместо composer.json. Обратите внимание, что это нельзя использовать вместе с параметром --global .
• --absolute: возвращает абсолютные пути при получении значений конфигурации * -dir вместо относительных.

# Модифицирующие репозитории

Помимо изменения раздела config, команда config также позволяет вносить изменения в раздел репозиториев с помощью следующих команд:

composer config repositories.foo vcs https://github.com/foo/bar

Если вашему репозиторию требуется больше параметров конфигурации, вы можете вместо этого передать его представление JSON:

composer config repositories.foo ‘{
“type”: ”vcs”,
“url”: ”http://svn.example.org/my-project/”,
“trunk-path” : “master”
}’

# Модификация дополнительных значений

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

composer config extra.foo.bar value

Точки указывают на вложенность массива, однако допускается максимальная глубина 3 уровня. Выше было бы установить "extra": {"foo": {"bar": "value"}}.

# создать-проект

Мы можем использовать Composer для создания новых проектов из существующего пакета. Это эквивалентно выполнению проверки git clone с последующей установкой композитором поставщиков.

«Создать-проект» имеет несколько приложений:

1. Мы можем развернуть пакеты приложений.
2. Мы можем проверить любой пакет и начать разработку, например, патчей.
3. Проекты с несколькими разработчиками могут использовать эту функцию для начальной загрузки исходного приложения для разработки.

Для создания нового проекта с помощью Composer мы можем использовать команду create-project . Передав ему имя пакета и каталог для создания проекта. Мы также можем предоставить версию в качестве третьего аргумента, поэтому при создании проекта используется последняя версия.

Если каталог в настоящее время не существует, он будет создан во время установки. Пример формата для создания проекта показан ниже:

composer  create-project doctrine/orm  path 2.2.*

Также можно выполнить команду без параметров в каталоге с существующим файлом composer.json для начальной загрузки проекта.

Композитор create-project может использоваться со следующими необязательными параметрами:

• --stability (-s): минимальная стабильность пакета. По умолчанию стабильный, если не указан.
• --prefer-source: устанавливать пакеты из источника, если он указан.
• --prefer-dist: устанавливать пакеты из dist, если указано.
• --repository: если указан пользовательский репозиторий для поиска пакета, он будет использоваться вместо packagist.
• --dev: Установить пакеты, перечисленные в разделе require-dev файла composer.json.
• --no-dev: отключает установку пакетов require-dev в файле composer.json
• --no-scripts : отключает выполнение сценариев, определенных в корневом пакете.
• --no-progress: удаляет отображение хода выполнения, которое может связываться с некоторыми терминалами или скриптами, которые не обрабатывают символы возврата.
• --no-secure-http: временно отключить параметр config secure-http при установке корневого пакета. Используйте на свой риск. Использование этого флага - плохая идея.
• --keep-vcs: пропустить удаление метаданных VCS для созданного проекта. Это в основном полезно, если вы запускаете команду в неинтерактивном режиме.
• --remove-vcs: принудительно удалить метаданные VCS без запроса.
• --no-install: отключает установку поставщиков.
• --ignore-platform-reqs: игнорировать требования php, hhvm, lib- * и ext- * и форсировать установку, даже если локальный компьютер не выполняет их.

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