shaneholloman.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 shaneholloman.php pour l'installer).
git doit être installé et fonctionnel (vous pouvez utiliser le rôle shaneholloman.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 accessible sur votre système. Il doit être dans le $PATH de votre utilisateur pour que vous puissiez exécuter des commandes simplement avec composer au lieu du chemin complet.

composer_keep_updated: false

Mettez 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 et la propriété du répertoire COMPOSER_HOME ; 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 (utilisant composer global require). Si vous souhaitez installer des paquets globaux, ajoutez un élément de liste avec un dictionnaire contenant le nom du paquet et un release, par exemple - { name: phpunit/phpunit, release: "4.7.*" }. Le 'release' est optionnel 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 à l'intérieur de 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 à l'intérieur de 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 l'API GitHub lors de la construction et de la reconstruction d'applications utilisant Composer. Suivez les instructions de GitHub pour Créer un token d'accès personnel si vous rencontrez ces erreurs de limite.

php_executable: php

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

Rester sur Composer 1

Alors que les projets se mettent à jour pour prendre en charge Composer 2, il peut être utile d'exécuter Composer 1 à la place. Pour ce faire, réglez ces variables :

composer_version_branch: ''
composer_version: '1.10.12'

Dépendances

Aucune (mais assurez-vous d'avoir installé PHP ; le rôle shaneholloman.php est recommandé).

Exemple de Playbook

- hosts: servers
  roles:
    - shaneholloman.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.