geerlingguy.composer

Rola Ansible: Composer

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

Wymagania

php (wersja 5.4+) powinien być zainstalowany i działać (możesz użyć roli geerlingguy.php do instalacji).
git powinien być zainstalowany i działać (możesz użyć roli geerlingguy.git do instalacji).

Zmienne Roli

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

composer_path: /usr/local/bin/composer

Ścieżka, w której Composer będzie zainstalowany i dostępny w systemie. Powinna znajdować się w $PATH użytkownika, aby można było uruchamiać komendy po prostu używając composer zamiast pełnej ścieżki.

composer_keep_updated: false

Ustaw to na true, aby aktualizować Composer do najnowszej wersji za każdym razem, gdy skrypt jest uruchamiany.

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

Ścieżka COMPOSER_HOME oraz właściciel katalogu; jest to katalog, w którym będą instalowane globalne paczki.

composer_version: ''

Możesz zainstalować konkretną wersję Composera, np. composer_version: '1.0.0-alpha11'. Jeśli pozostawisz puste, zainstalowana zostanie 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ą wersję Composera chcesz używać. Domyślnie jest to --2. Uwaga: composer_keep_updated zaktualizuje najnowszą wersję dostępną dla tej wersji.

composer_global_packages: []

Lista paczek do zainstalowania globalnie (używając composer global require). Jeśli chcesz zainstalować jakieś paczki globalnie, dodaj element listy z słownikiem zawierającym name paczki oraz release, np. - { name: phpunit/phpunit, release: "4.7.*" }. Pole 'release' jest opcjonalne i domyślnie to @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 composera.

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 unikania błędów z ograniczeniami API GitHub podczas budowania i odbudowywania aplikacji przy użyciu Composera. Postępuj zgodnie z instrukcjami GitHub, aby utworzyć osobisty token dostępu, jeśli napotkasz te błędy z ograniczeniem.

php_executable: php

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

Praca na Composer 1

Podczas aktualizowania projektów, aby wspierały Composer 2, może być pomocne korzystanie z Composer 1. Aby to zrobić, ustaw te zmienne:

composer_version_branch: ''
composer_version: '1.10.12'

Zależności

Brak (ale upewnij się, że zainstalowano PHP; zaleca się rolę geerlingguy.php).

Przykład Skryptu

- hosts: serwery
  roles:
    - geerlingguy.composer

Po uruchomieniu skryptu, composer zostanie umieszczony w /usr/local/bin/composer (to miejsce jest konfigurowalne) i będzie dostępny za pomocą normalnych kont systemowych.