shaneholloman.composer

Rola Ansible: `composer`

Instaluje Composer, menedżera zależności PHP, na dowolnym systemie Linux lub UNIX.

Wymagania

php (wersja 5.4 lub nowsza) powinien być zainstalowany i działający (możesz użyć roli shaneholloman.php, aby go zainstalować).
git powinien być zainstalowany i działający (możesz użyć roli shaneholloman.git, aby go zainstalować).

Zmienne Roli

Dostępne zmienne są wymienione poniżej, wraz z wartościami domyślnymi (patrz defaults/main.yml):

composer_path: /usr/local/bin/composer

Ścieżka, w której Composer zostanie zainstalowany i będzie dostępny w twoim systemie. Powinna znajdować się w $PATH twojego użytkownika, aby polecenia można było uruchamiać po prostu za pomocą composer, a nie pełnej ścieżki.

composer_keep_updated: false

Ustaw tę opcję na true, aby aktualizować Composera do najnowszej wersji za każdym razem, gdy uruchamiany jest playbook.

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

Ścieżka COMPOSER_HOME i informacje o właścicielu katalogu; jest to katalog, w którym będą instalowane globalne pakiety.

composer_version: ''

Możesz zainstalować określoną wersję Composera, np. composer_version: '1.0.0-alpha11'. Jeśli zostawisz to puste, zostanie zainstalowana najnowsza wersja deweloperska. Uwaga: composer_keep_updated nadpisze tę zmienną, ponieważ zawsze zainstaluje najnowszą wersję deweloperską.

composer_version_branch: '--2'

Możesz wybrać, którą główną gałąź Composera chcesz użyć. Domyślnie jest to --2. Uwaga: composer_keep_updated zaktualizuje najnowszą wersję dostępną dla tej gałęzi.

composer_global_packages: []

Lista pakietów do zainstalowania globalnie (używając composer global require). Jeśli chcesz zainstalować jakieś pakiety globalnie, dodaj pozycję z słownikiem z name pakietu i release, np. - { name: phpunit/phpunit, release: "4.7.*" }. Pole release jest opcjonalne i domyślnie wynosi @stable.

composer_add_to_path: true

Jeśli true, a jeśli są skonfigurowane composer_global_packages, katalog vendor/bin wewnątrz composer_home_path zostanie dodany do domyślnego $PATH systemu (dla wszystkich użytkowników).

composer_project_path: /path/to/project

Ścieżka do projektu Composer.

composer_add_project_to_path: false

Jeśli true, a jeśli skonfigurowano composer_project_path, katalog vendor/bin wewnątrz composer_project_path zostanie dodany do domyślnego $PATH systemu (dla wszystkich użytkowników).

composer_github_oauth_token: ''

Token OAuth GitHub, używany do uniknięcia błędów limitu API GitHub podczas budowania i odbudowywania aplikacji za pomocą Composera. Postępuj zgodnie z instrukcjami GitHub, aby utworzyć osobisty token dostępu, jeśli napotkasz te błędy limitu.

php_executable: php

Nazwa pliku wykonywalnego lub pełna ścieżka do wykonawczego pliku PHP. Domyślnie jest to php, jeśli nie nadpiszesz tej zmiennej.

Pozostawanie przy Composer 1

Podczas gdy projekty aktualizują, aby wspierać Composer 2, może być pomocne korzystanie z Composera 1. Aby to zrobić, ustaw te zmienne:

composer_version_branch: ''
composer_version: '1.10.12'

Zależności

Brak (ale upewnij się, że zainstalowałeś PHP; zaleca się użycie roli shaneholloman.php).

Przykładowy Playbook

- hosts: servers
  roles:
    - shaneholloman.composer

Po uruchomieniu playbooka, composer zostanie umieszczony w /usr/local/bin/composer (to miejsce można skonfigurować) i będzie dostępny za pośrednictwem normalnych kont systemowych.