shaneholloman.composer

Ansible Роль: `composer`

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

Требования

php (версия 5.4+) должен быть установлен и работать (вы можете использовать роль shaneholloman.php для установки).
git должен быть установлен и работать (вы можете использовать роль shaneholloman.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, используемый для избежания ошибок ограничения скорости API GitHub при сборке и переборке приложений с помощью Composer. Следуйте инструкциям GitHub, чтобы Создать токен доступа, если вы столкнулись с этими ошибками ограничения скорости.

php_executable: php

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

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

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

composer_version_branch: ''
composer_version: '1.10.12'

Зависимости

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

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

- hosts: servers
  roles:
    - shaneholloman.composer

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