geerlingguy.composer

Rôle Ansible : Composer

Installe Composer, le gestionnaire de dépendances PHP, sur tout système Linux ou UNIX.

Exigences

php (version 5.4+) doit être installé et fonctionnel (vous pouvez utiliser le rôle geerlingguy.php pour l'installer).
git doit être installé et fonctionnel (vous pouvez utiliser le rôle geerlingguy.git pour l'installer).

Variables du Rôle

Les variables disponibles sont listées ci-dessous, avec les valeurs par défaut (voir defaults/main.yml) :

composer_path: /usr/local/bin/composer

Le chemin où Composer sera installé et disponible sur votre système. Il doit être dans le $PATH de votre utilisateur afin que vous puissiez exécuter des commandes simplement avec composer au lieu du chemin complet.

composer_keep_updated: false

Définissez ceci sur true pour mettre à jour Composer à la dernière version à chaque exécution du playbook.

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

Le chemin COMPOSER_HOME et la propriété du répertoire ; c'est le répertoire où les paquets globaux seront installés.

composer_version: ''

Vous pouvez installer une version spécifique de Composer, par exemple composer_version: '1.0.0-alpha11'. Si laissé vide, la dernière version de développement sera installée. Notez que composer_keep_updated remplacera cette variable, car elle installera toujours la dernière version de développement.

composer_version_branch: '--2'

Vous pouvez choisir quelle branche majeure de Composer vous souhaitez utiliser. Par défaut, c'est --2. Notez que composer_keep_updated mettra à jour la dernière version disponible pour cette branche.

composer_global_packages: []

Une liste de paquets à installer globalement (en utilisant composer global require). Si vous souhaitez installer des paquets globalement, ajoutez un élément de liste avec un dictionnaire comprenant le nom du paquet et une version, par exemple - { name: phpunit/phpunit, release: "4.7.*" }. La 'version' est optionnelle et par défaut à @stable.

composer_add_to_path: true

Si true, et s'il y a des composer_global_packages configurés, le répertoire vendor/bin dans composer_home_path sera ajouté au $PATH par défaut du système (pour tous les utilisateurs).

composer_project_path: /path/to/project

Chemin vers un projet composer.

composer_add_project_to_path: false

Si true, et si vous avez configuré un composer_project_path, le répertoire vendor/bin dans composer_project_path sera ajouté au $PATH par défaut du système (pour tous les utilisateurs).

composer_github_oauth_token: ''

Token OAuth GitHub, utilisé pour éviter les erreurs de limitation de fréquence de l'API GitHub lors de la création et de la reconstruction d'applications utilisant Composer. Suivez les instructions de GitHub pour Créer un jeton d'accès personnel si vous rencontrez ces erreurs de limitation.

php_executable: php

Le nom exécutable ou le chemin complet vers l'exécutable PHP. Ceci est par défaut à php si vous ne remplacez pas la variable.

Rester sur Composer 1

Alors que les projets se mettent à niveau pour supporter Composer 2, il peut être utile d'exécuter Composer 1 à la place. Pour cela, définissez ces variables :

composer_version_branch: ''
composer_version: '1.10.12'

Dépendances

Aucune (mais assurez-vous que vous avez installé PHP ; le rôle geerlingguy.php est recommandé).

Exemple de Playbook

- hosts: servers
  roles:
    - geerlingguy.composer

Après l'exécution du playbook, composer sera placé dans /usr/local/bin/composer (cet emplacement est configurable) et sera accessible via les comptes système normaux.