shaneholloman.composer

Ansible Rolle: `composer`

Installiert Composer, den PHP-Abhängigkeitsmanager, auf jedem Linux- oder UNIX-System.

Anforderungen

php (Version 5.4+) sollte installiert und funktionsfähig sein (du kannst die Rolle shaneholloman.php verwenden, um dies zu installieren).
git sollte installiert und funktionsfähig sein (du kannst die Rolle shaneholloman.git verwenden, um dies zu installieren).

Rollenvariablen

Verfügbare Variablen sind unten aufgelistet, zusammen mit Standardwerten (siehe defaults/main.yml):

composer_path: /usr/local/bin/composer

Der Pfad, wo Composer installiert und deinem System zur Verfügung steht. Er sollte im $PATH deines Benutzers enthalten sein, damit du Befehle einfach mit composer anstelle des vollständigen Pfads ausführen kannst.

composer_keep_updated: false

Setze dies auf true, um Composer bei jedem Ausführen des Playbooks auf die neueste Version zu aktualisieren.

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

Der COMPOSER_HOME-Pfad und die Verzeichnisbesitzer; dies ist das Verzeichnis, in dem globale Pakete installiert werden.

composer_version: ''

Du kannst eine bestimmte Version von Composer installieren, z. B. composer_version: '1.0.0-alpha11'. Wenn du dies leer lässt, wird die neueste Entwicklungsversion installiert. Beachte, dass composer_keep_updated diese Variable überschreibt, da es immer die neueste Entwicklungsversion installiert.

composer_version_branch: '--2'

Du kannst auswählen, welchen Hauptzweig von Composer du verwenden möchtest. Standard ist --2. Beachte, dass composer_keep_updated die neueste verfügbare Version für diesen Zweig aktualisiert.

composer_global_packages: []

Eine Liste von Paketen, die global installiert werden sollen (mit composer global require). Wenn du globale Pakete installieren möchtest, füge einen Listeneintrag mit einem Wörterbuch mit dem name des Pakets und einem release hinzu, z. B. - { name: phpunit/phpunit, release: "4.7.*" }. Der 'release' ist optional und hat standardmäßig den Wert @stable.

composer_add_to_path: true

Wenn true, und wenn es konfigurierte composer_global_packages gibt, wird das Verzeichnis vendor/bin im composer_home_path zum Standard-$PATH des Systems hinzugefügt (für alle Benutzer).

composer_project_path: /path/to/project

Pfad zu einem Composer-Projekt.

composer_add_project_to_path: false

Wenn true, und wenn du einen composer_project_path konfiguriert hast, wird das Verzeichnis vendor/bin im composer_project_path zum Standard-$PATH des Systems hinzugefügt (für alle Benutzer).

composer_github_oauth_token: ''

GitHub OAuth-Token, das verwendet wird, um Fehler durch API-Ratebegrenzung von GitHub beim Erstellen und Neubauen von Anwendungen mit Composer zu vermeiden. Befolge die Anweisungen von GitHub, um ein persönliches Zugangstoken zu erstellen, wenn du auf diese Ratebegrenzungsfehler stößt.

php_executable: php

Der Name des ausführbaren Programms oder der vollständige Pfad zur PHP-Ausführungsdatei. Dies ist standardmäßig auf php gesetzt, wenn du die Variable nicht überschreibst.

Bei Composer 1 bleiben

Während Projekte auf Composer 2 umsteigen, kann es sinnvoll sein, Composer 1 zu verwenden. Setze dazu diese Variablen:

composer_version_branch: ''
composer_version: '1.10.12'

Abhängigkeiten

Keine (aber stelle sicher, dass du PHP installiert hast; die Rolle shaneholloman.php wird empfohlen).

Beispiel-Playbook

- hosts: servers
  roles:
    - shaneholloman.composer

Nach dem Ausführen des Playbooks wird composer in /usr/local/bin/composer installiert (dieser Ort ist konfigurierbar) und wird über normale Systemkonten zugänglich sein.