geerlingguy.composer

Ansible Роль: Composer

Устанавливает Composer, менеджер зависимостей PHP, на любую систему Linux или UNIX.

Требования

php (версии 5.4 и выше) должен быть установлен и работать (вы можете использовать роль geerlingguy.php для установки).
git должен быть установлен и работать (вы можете использовать роль geerlingguy.git для установки).

Переменные роли

Доступные переменные перечислены ниже, вместе с значениями по умолчанию (см. defaults/main.yml):

composer_path: /usr/local/bin/composer

Путь, по которому будет установлен и доступен Composer на вашей системе. Должен быть в $PATH вашего пользователя, чтобы вы могли запускать команды просто с помощью composer, а не полного пути.

composer_keep_updated: false

Установите это значение в true, чтобы обновлять Composer до последней версии каждый раз при запуске плейбука.

composer_home_path: '~/.composer'
composer_home_owner: root
composer_home_group: root

Путь и права собственности для COMPOSER_HOME; это каталог, где будут устанавливаться глобальные пакеты.

composer_version: ''

Вы можете установить конкретную версию Composer, например, composer_version: '1.0.0-alpha11'. Если оставить пустым, будет установлена последняя версия разработки. Обратите внимание, что composer_keep_updated переопределит эту переменную, так как всегда будет устанавливать последнюю версию разработки.

composer_version_branch: '--2'

Вы можете выбрать, какую основную ветку Composer вы хотите использовать. По умолчанию это --2. Обратите внимание, что composer_keep_updated обновит последнюю доступную версию для этой ветки.

composer_global_packages: []

Список пакетов для глобальной установки (с помощью composer global require). Если вы хотите установить какие-либо пакеты глобально, добавьте элемент списка с словарем с name пакета и release, например, - { name: phpunit/phpunit, release: "4.7.*" }. Поле 'release' является необязательным и по умолчанию равно @stable.

composer_add_to_path: true

Если true, и если есть настроенные composer_global_packages, каталог vendor/bin внутри composer_home_path будет добавлен в системный $PATH по умолчанию (для всех пользователей).

composer_project_path: /path/to/project

Путь к проекту Composer.

composer_add_project_to_path: false

Если true, и если вы настроили composer_project_path, каталог vendor/bin внутри composer_project_path будет добавлен в системный $PATH по умолчанию (для всех пользователей).

composer_github_oauth_token: ''

Токен OAuth GitHub, используемый для избежания ошибок ограничения по количеству запросов к GitHub API при создании и восстановлении приложений с использованием Composer. Ознакомьтесь с инструкциями GitHub, чтобы создать персональный токен доступа, если у вас возникли ошибки ограничения.

php_executable: php

Имя исполняемого файла или полный путь к исполняемому файлу PHP. По умолчанию это php, если вы не переопределяете переменную.

Оставаться на Composer 1

Пока проекты обновляются для поддержки Composer 2, может быть полезно использовать Composer 1. Для этого установите следующие переменные:

composer_version_branch: ''
composer_version: '1.10.12'

Зависимости

Нет (но убедитесь, что вы установили PHP; рекомендуется использовать роль geerlingguy.php).

Пример плейбука

- hosts: servers
  roles:
    - geerlingguy.composer

После выполнения плейбука composer будет установлен в /usr/local/bin/composer (это местоположение можно настроить) и будет доступен через обычные системные аккаунты.