Рубрики
Uncategorized

[Передача] композитор – Документ – командная строка

Автор оригинала: David Wong.

Исходный адрес: командная строка composer

Глобальный параметр

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

  • –подробный (-v): Увеличьте детализацию информации об обратной связи.

    • – V обозначает нормальную выходную мощность.

    • – VV представляет более подробные выходные данные.

    • – VVV предназначен для отладки.

  • –справка (-h): Отображение справочной информации.

  • –тихо (-q): Вывод какой-либо информации не допускается.

  • –нет-взаимодействия (-n): Не задавайте никаких интерактивных вопросов.

  • –рабочий-dir (-d): Если указано, используйте данный каталог в качестве рабочего каталога.

  • –профиль: Отображение информации о времени и использовании памяти.

  • –ansi: Принудительный вывод ANSI.

  • –нет-анси: Закройте выход ANSI.

  • –версия (-V): Отображает информацию о версии для текущего приложения.

Код Выхода из Процесса

  • 0: обычный

  • 1: Общие/Неизвестные Ошибки

  • 2: Ошибки обработки зависимостей

Инициализация инициализации

В главе “Библиотека” мы рассмотрели, как создать ее вручную. композитор.json Документы. На самом деле есть еще один. init Команды могут сделать это проще.

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

php composer.phar init

Инициализация-параметры

  • –имя: Название пакета.

  • –описание: Описание упаковки.

  • –автор: Автор пакета.

  • –домашняя страница: Домашняя страница пакета.

  • –требуется: Другие пакеты, на которые необходимо полагаться, должны иметь ограничение версии. И за этим следует foo/bar:1.0.0 Этот формат.

  • –требуется-разработчик: Пакеты зависимостей, форматы содержимого и –требуется То же самое.

  • –стабильность (-ы): минимальная стабильность Значение поля.

установить установить

установить Команда, считанная из текущего каталога composer.json Файл, обработайте зависимости и установите их в поставщику В каталоге.

php composer.phar install

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

Без композитор.заблокируйте Файл, композитор создаст его после работы с зависимостями.

Установка-параметры

  • –предпочитаю-источник: Есть два способа загрузить пакет: источник и пыль 。 Для стабильной версии композера он будет использоваться по умолчанию dist Способом. и источник Представляет источник управления версиями. Если --предпочитаю-источник Если включено, композитор будет из источника установки (если таковая имеется). Это очень полезно, если вы хотите использовать исправление ошибок в своем проекте. И зависимости могут быть получены непосредственно из локальных библиотек версий.

  • –предпочитаю-dist: и --предпочитаю-источник Вместо этого композитор сделает все возможное из dist Получите, что значительно ускорит установку на серверах сборки. Это также способ избежать проблем с git, если вы не знаете, как их правильно настроить.

  • –сухой прогон: Если вы просто хотите продемонстрировать, а на самом деле не устанавливать пакет, вы можете запустить его --сухой запуск командой, которая имитирует установку и отображает, что произойдет.

  • –dev: установить требуется-dev Пакет, указанный в поле (это значение по умолчанию).

  • –нет-dev: пропустить требуется-dev Пакеты, указанные в поле.

  • –нет-скрипты: пропустить композитор.json Сценарий, определенный в файле.

  • –нет-плагинов: Закройте плагины.

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

  • –оптимизация-автозагрузчик (-o): Преобразование автоматической загрузки PSR-0/4 в classmap обеспечивает более быструю поддержку загрузки. Особенно в производственной среде рекомендуется это делать, но поскольку для запуска требуется некоторое время, это значение не является значением по умолчанию.

Для обновления

Чтобы получить последнюю версию зависимостей и обновить composer.заблокируйте Документы, вы должны использовать команду обновить .

php composer.phar update

Это устраняет все зависимости проекта и записывает точный номер версии composer.блокировка

Если вы просто хотите обновить несколько пакетов, вы можете перечислить их отдельно следующим образом:

php composer.phar update vendor/package vendor/package2

Вы также можете использовать подстановочные знаки для пакетных обновлений:

php composer.phar update vendor/*

Обновление-параметры

  • –предпочитаю-источник: При наличии доступных пакетов, из источника Установки.

  • –предпочитаю-dist: При наличии доступных пакетов, из dist Установка.

  • –сухой запуск: Имитированные команды не выполняют фактическую операцию.

  • –dev: установить требуется-dev Пакет, указанный в поле (это значение по умолчанию).

  • –нет-dev: пропустить требуется-dev Пакеты, указанные в поле.

  • –нет-скрипты: пропустить композитор.json Сценарий, определенный в файле.

  • –нет-плагинов: Закройте плагины.

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

  • –оптимизация-автозагрузчик (-o): Преобразование автоматической загрузки PSR-0/4 в classmap обеспечивает более быструю поддержку загрузки. Особенно в производственной среде рекомендуется это делать, но поскольку для запуска требуется некоторое время, это значение не является значением по умолчанию.

  • –блокировка: Просто обновите хэш файла блокировки и отмените предупреждение об устаревании файла блокировки.

  • –с-зависимостями В то же время обновляются зависимости пакетов белого списка, которые будут обновляться рекурсивно.

Подтверждение уверенности требует

требуется Команда для добавления новых пакетов зависимостей в текущий каталог composer.json В документе.

php composer.phar require

При добавлении или изменении зависимостей измененные зависимости будут установлены или обновлены.

Если вы не хотите указывать пакеты зависимостей путем взаимодействия, вы можете указать пакеты зависимостей непосредственно в этом порядке.

php composer.phar require vendor/package:2.* vendor/package2:dev-master

Зависимость подтверждения-Параметр

  • –предпочитаю-источник: При наличии доступных пакетов, из источника Установки.

  • –предпочитаю-dist: При наличии доступных пакетов, из dist Установка.

  • –dev: установить требуется-dev Пакеты, перечисленные в поле.

  • –без обновления: Отключить автоматическое обновление зависимостей.

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

  • –обновление-с-зависимостями Обновите зависимости новых пакетов вместе.

Глобальное исполнение глобальное

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

И если вы хотите $COMPOSER_HOME/поставщик/бин Присоединиться $ПУТЬ В переменных среды вы можете использовать его для установки глобальных приложений в командной строке. Вот пример:

php composer.phar global require fabpot/php-cs-fixer:dev-master

Сейчас php-cs-фиксаж Его можно использовать глобально (при условии, что вы настроили свой ПУТЬ). Если вы хотите обновить его позже, вам просто нужно запустить его глобальное обновление :

php composer.phar global update

поиск поиск

Команда search позволяет выполнять поиск пакетов зависимостей для текущих проектов. Обычно он ищет только упаковщика. Организационные пакеты. Вы можете просто ввести свои критерии поиска.

php composer.phar search monolog

Вы также можете выполнять поиск по нескольким условиям, передавая несколько параметров.

Параметры поиска

  • –только-имя (-N): Поиск только по указанному имени (идеальное совпадение).

Выставочная выставка

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

php composer.phar show

Если вы хотите просмотреть подробные сведения о пакете, вы можете ввести имя пакета.

php composer.phar show monolog/monolog

name     : monolog/monolog
versions : master-dev, 1.0.2, 1.0.1, 1.0.0, 1.0.0-RC1
type     : library
names    : monolog/monolog
source   : [git] http://github.com/Seldaek/monolog.git 3d4e60d0cbc4b888fe5ad223d77964428b1978da
dist     : [zip] http://github.com/Seldaek/monolog/zipball/3d4e60d0cbc4b888fe5ad223d77964428b1978da 3d4e60d0cbc4b888fe5ad223d77964428b1978da
license  : MIT

autoload
psr-0
Monolog : src/

requires
php >=5.3.0

Вы даже можете ввести номер версии пакета, чтобы отобразить сведения об этой версии.

php composer.phar show monolog/monolog 1.0.2

Дисплей-параметр

  • –установлено (-i): Список установленных пакетов зависимостей.

  • –платформа (-p): Перечислите только пакеты платформы (PHP и его расширения).

  • –self (-ы): Перечислите только текущую информацию о проекте.

Обнаружение зависимостей зависит

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

php composer.phar depends --link-type=require monolog/monolog

nrk/monolog-fluent
poc/poc
propel/propel
symfony/monolog-bridge
symfony/symfony

Обнаружение зависимостей – Параметры

  • –тип связи: Тип обнаружения по умолчанию – требуется Это также может быть require-dev

Проверка эффективности обнаружения

Отправка composer.json Файлов, и перед созданием тегов вы всегда должны запускать проверять Заказ. Это будет испытанием для вас. composer.json Является ли файл действительным?

php composer.phar validate

Параметры проверки достоверности

  • –без-проверки-все: Выполняет ли Composer полную проверку.

Состояние обнаружения зависимого состояния пакета

Если вы часто изменяете независимые от кода пакеты, и они устанавливаются из исходного кода (пользовательского источника), то статус Команда позволяет вам проверить, и она подскажет вам, есть ли у вас какие-либо локальные изменения.

php composer.phar status

Ты можешь им воспользоваться. --многословно Ряд параметров (-v | v v | v v v) для получения более подробной информации:

php composer.phar status -v

You have changes in the following dependencies:
vendor/seld/jsonlint:
    M README.mdown

Самообновление самообновление

Для обновления самого Composer до последней версии требуется только выполнить команду self-update . Он заменит твой. composer.phar Файл до последней версии.

php composer.phar self-update

Если вы хотите перейти на определенную версию, вы можете просто указать ее:

php composer.phar self-update 1.0.0-alpha7

Если вы установили Composer для всей системы (см. раздел Глобальная установка), вам может потребоваться root Запустите его с разрешения:

sudo composer self-update

Самообновление-параметры

  • –откат (-r): Откат к последней установленной версии.

  • –очистка резервных копий: Удалите старую резервную копию во время процесса обновления, что делает текущую версию после обновления единственной доступной резервной копией.

Изменение конфигурации

Команды config позволяют редактировать некоторые основные настройки Composer, будь то локальные composer.json Или Глобальный config.json Документы.

php composer.phar config --list

Изменение конфигурации – способ использования

конфигурация [параметры] [клавиша настройки] [значение настройки 1] … [[значение настройки]

настройка-клавиша Это имя параметра конфигурации. настройка-значение1 Является значением конфигурации. Массивы могут использоваться в качестве значений конфигурации (например, github-протоколы ), многие значения настроек Это допустимо.

Для получения допустимых параметров конфигурации см. раздел Конфигурация в разделе Архитектура.

Изменение конфигурации – параметров

  • –глобальный (-g): Операция расположена $COMPOSER_HOME/config.json Файл глобальной конфигурации. Если этот параметр не указан, эта команда повлияет на составителя. Файл JSON для текущего проекта или --файл Файл, на который ссылается параметр.

  • –редактор (-e): Откройте композитор. Файл JSON с помощью текстового редактора. По умолчанию вы всегда открываете файл для текущего проекта. Когда существует --глобальный Когда используется параметр, глобальный композитор. Откроется файл JSON.

  • –не установлено: Удалить из ключ настройки Укажите параметры конфигурации имени.

  • –список (-l): Отображает список текущих параметров конфигурации. Когда он существует --глобальный При использовании параметров отображается список параметров глобальной конфигурации.

  • –файл=”…” (-f): Работайте с указанным файлом, а не с композитором. джсон. Примечание: Не с --global Параметры используются вместе.

Изменить источник пакета

В дополнение к изменению параметров конфигурации, config Команда также поддерживает изменение исходной информации путем:

php composer.phar config repositories.foo vcs http://github.com/foo/bar

Создать проект создать проект

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

Эта команда имеет несколько общих применений:

  1. Вы можете быстро развернуть свое приложение.

  2. Вы можете проверить любой пакет ресурсов и разработать его исправления.

  3. Для ускорения инициализации приложений можно использовать проекты разработки с участием нескольких человек.

Чтобы создать новый проект на основе Composer, вы можете использовать команду “создать-проект”. Введите имя пакета, которое создаст для вас каталог проекта. Вы также можете указать номер версии в третьем параметре, в противном случае вы получите последнюю версию.

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

php composer.phar create-project doctrine/orm path 2.2.*

Кроме того, вы можете использовать существующую команду вместо ее использования. composer.json Файл для запуска проекта.

По умолчанию эта команда находит пакет, указанный вами в packagist. орг..

Создать проект-параметры

  • –репозиторий-url: Предоставьте пользовательский репозиторий для поиска пакетов, которые будут использоваться вместо packagist.org. Это может быть указывающий композитор URL-адрес HTTP репозитория или указывает на пакеты.json Локальный путь к файлу.

  • –стабильность (-ы): Минимальная стабильная версия пакета ресурсов, по умолчанию стабильная

  • –предпочитаю-источник: При наличии доступных пакетов, из источника Установки.

  • –предпочитаю-dist: При наличии доступных пакетов, из dist Установка.

  • –dev: установить требуется-dev Пакеты, перечисленные в поле.

  • –не устанавливать: Запретить зависимости от установочных пакетов.

  • –нет-плагинов: Отключить плагины.

  • –нет-скриптов: Запретить выполнение скрипта, определенного в пакете корневых ресурсов.

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

  • –keep-vcs: Отсутствующие VCS пропускаются при создании. Если вы запустите команду “Создать” в неинтерактивном режиме, это будет очень полезно.

Печать дампа индекса автоматической загрузки-автоматическая загрузка

В некоторых случаях вам необходимо обновить загрузчик, например, добавив новый класс в свой пакет. Ты можешь им воспользоваться. сброс-автоматическая загрузка Для завершения, а не для выполнения установки или обновления команды.

Кроме того, он может печатать оптимизированный индекс классов, соответствующих спецификации PSR-0/4, что также необходимо для повышения производительности. В больших приложениях будет много видов файлов, и автозапуск будет занимать большую часть времени каждого запроса. Может быть неудобно использовать карты классов при разработке, но он все равно может получить удобство спецификации PSR-0/4 при условии гарантии производительности.

Печать Индекса Автоматической загрузки-Параметры

  • –оптимизация (-o): Преобразование автоматической загрузки PSR-0/4 в classmap для повышения скорости загрузки. Это особенно применимо в производственных средах, но для запуска может потребоваться некоторое время, поэтому в настоящее время это не параметр по умолчанию.

  • –нет-dev: Отключите правило автоматической загрузки.

Просмотр лицензии лицензии на соглашения

Укажите имя, версию, лицензионное соглашение каждого установленного пакета. имейте доступ к --format=json Параметрам, чтобы получить выходные данные в формате JSON.

Сценарий выполнения run-скрипт

Вы можете запустить эту команду для выполнения сценария вручную, просто укажите имя сценария, необязательно --no-dev Параметры позволяют отключить режим разработчика.

Диагностика диагностика

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

php composer.phar diagnose

Файловый поиск

Эта команда используется для архивирования zip/tar указанной версии указанного пакета. Он также может быть использован для архивирования всего вашего проекта, исключенных/игнорируемых файлов.

php composer.phar archive vendor/package 2.0.21 --format=zip

Архивы – параметры

  • –формат (-f): Укажите формат архивирования: tar или zip (по умолчанию используется tar).

  • –dir: Укажите каталог, в котором хранится архив (по умолчанию это текущий каталог).

Получить справочную информацию справка

Используйте справка Можно получить справочную информацию для указанной команды.

php composer.phar help install

переменная среды

Вы можете задать некоторые переменные среды, чтобы переопределить конфигурацию по умолчанию. Предложения, насколько это возможно composer.json Из конфиг Установите эти значения в поле вместо установки переменных среды из командной строки. Стоит отметить, что значения в переменных среды всегда будут иметь приоритет над значениями в переменных среды. composer.json Значение, указанное в.

КОМПОЗИТОР

переменная окружения КОМПОЗИТОР Может быть composer.json Файлы укажите другие имена файлов.

Например:

COMPOSER=composer-other.json php composer.phar install

COMPOSER_ROOT_VERSION

Установив эту переменную среды, вы можете указать версию корневого пакета, если программа не может угадать номер публикации из VCS, и его там нет. composer.json Об этом говорится в документе.

КОМПОЗИТОР_ВЕНДОР_ДИР

Установив эту переменную среды, вы можете указать, что composer будет устанавливать зависимости поставщик В других каталогах.

COMPOSER_BIN_DIRECTORY

Установив эту переменную среды, вы можете указать бункер (Двоичные файлы поставщика) каталог в поставщик/bin Другие каталоги.

http_proxy или HTTP_PROXY

Если вы используете Composer через HTTP-прокси, вы можете использовать его http_proxy или HTTP_PROXY Переменные среды. Просто установите его на URL прокси-сервера. Многие операционные системы установили эту переменную для ваших служб.

Рекомендуемое применение http_proxy (в нижнем регистре) или и то, и другое. Потому что некоторые инструменты, такие как git или curl, будут использовать http_proxy Версия в нижнем регистре. Кроме того, вы можете использовать его git config --глобальный http.прокси прокси> прокси>

no_proxy

Если вы используете прокси-сервер и хотите отключить прокси-сервер для некоторых доменных имен, вы можете использовать прокси-сервер. no_proxy Переменные среды. Просто введите разделенное запятыми доменное имя Исключить Список.

Эта переменная среды принимает доменные имена, IP-адреса и блоки адресов CIDR. Вы можете ограничить его портом (например: :80 (2) Результаты исследования следующие:1) Результаты исследования следующие:1) Результаты исследования следующие:1) Результаты исследования следующие:1. Вы также можете установить его в * Игнорировать все запросы HTTP-прокси.

HTTP_PROXY_REQUEST_FULLURL

Если вы используете HTTP-прокси, он его не поддерживает request_fullurl Тег, затем вы должны установить переменную среды в false или 0 Чтобы помешать композитору request_fullurl Прочитайте конфигурацию.

HTTPS_PROXY_REQUEST_FULLURL

Если вы используете HTTPS-прокси, он его не поддерживает request_fullurl Тег, затем вы должны установить переменную среды в false или 0 Чтобы помешать композитору request_fullurl Прочитайте конфигурацию.

ДОМ КОМПОЗИТОРА

Переменные среды COMPOSER_HOME позволяют изменять домашний каталог композитора. Это скрытый глобальный каталог, общий для всех проектов (доступный всем локальным пользователям).

Его значения по умолчанию в каждой системе следующие:

  • *никс /главная страница/<пользователь>/.композитор

  • OSX /Пользователи/<пользователь>/.Композитор

  • Окна C:\Users\<пользователь>\AppData\Роуминг\Композитор

COMPOSER_HOME/config.json

Ты можешь быть там. КОМПОЗИЦИОННЫЙ ДОМ Поместите один из них в каталог config.json Документы. В вашем исполнении установите и обновление По команде Composer будет использовать его с вашим проектом composer.json Документы объединяются.

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

если Общая ситуация и проект Если такой же элемент конфигурации существует, то в проекте composer.json Файлы имеют более высокий приоритет.

COMPOSER_CACHE_DIR

Переменные среды COMPOSER_CACHE_DIR позволяют задать каталог кэша композитора, который также можно использовать в конфигурации cachedir .

Его значения по умолчанию в каждой системе следующие:

  • *nix и OSX $COMPOSER_HOME/кэш

  • Окна C:\Users\<пользователь>\AppData\Локальный\Композитор или %LOCALAPPDATA%/Композитор

COMPOSER_PROCESS_TIMEOUT

Эта переменная среды управляет временем ожидания выполнения команд Composer (например, команд git). Значение по умолчанию-300 секунд (5 минут).

COMPOSER_DISCARD_CHANGES

Эта переменная среды управляет параметром конфигурации “Отменить изменения”.

КОМПОЗИТОР_НО_ИНТЕРФЕЙС

Если значение равно 1, эта переменная среды приведет к тому, что Composer откажется от взаимодействия при выполнении каждой команды, что эквивалентно использованию всех команд. --отсутствие взаимодействия 。 Может быть построена Виртуальная машина/Сервер непрерывной интеграции Установите его таким образом.

Оригинал: “https://developpaper.com/transfer-composer-document-command-line/”