Ansibleロール: Composer

PHPの依存関係マネージャーであるComposerを、LinuxまたはUNIXシステムにインストールします。

必要条件

• php（バージョン5.4以上）がインストールされ、動作している必要があります（インストールにはgeerlingguy.phpロールを使用できます）。
• gitがインストールされ、動作している必要があります（インストールにはgeerlingguy.gitロールを使用できます）。

ロール変数

使用可能な変数は以下に示し、デフォルト値を記載しています（defaults/main.ymlを参照）：

composer_path: /usr/local/bin/composer

Composerがインストールされるパスで、システムで利用可能となります。ユーザーの$PATH内にあるべきで、フルパスを使わずにcomposerコマンドを直接実行できます。

composer_keep_updated: false

これをtrueに設定すると、プレイブックが実行されるたびにComposerが最新リリースに更新されます。

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

COMPOSER_HOMEのパスとディレクトリの所有者; これは、グローバルパッケージがインストールされるディレクトリです。

composer_version: ''

特定のComposerリリースをインストールできます。例：composer_version: '1.0.0-alpha11'。空のままにすると最新の開発版がインストールされます。なお、composer_keep_updatedはこの変数を上書きし、常に最新の開発版をインストールします。

composer_version_branch: '--2'

使用するComposerのメジャーブランチを選択できます。デフォルトは--2です。composer_keep_updatedはこのブランチの最新バージョンを更新します。

composer_global_packages: []

グローバルにインストールするパッケージのリスト（composer global requireを使用）です。グローバルにインストールしたいパッケージがある場合は、パッケージ名とリリースを持つ辞書をリストに追加します。例：- { name: phpunit/phpunit, release: "4.7.*" }。'release'はオプションで、デフォルトは@stableです。

composer_add_to_path: true

trueの場合、構成されたcomposer_global_packagesがあると、composer_home_path内のvendor/binディレクトリがシステムのデフォルト$PATHに追加されます（すべてのユーザー用）。

composer_project_path: /path/to/project

Composerプロジェクトへのパスです。

composer_add_project_to_path: false

trueの場合、composer_project_pathを構成していると、composer_project_path内のvendor/binディレクトリがシステムのデフォルト$PATHに追加されます（すべてのユーザー用）。

composer_github_oauth_token: ''

GitHubのOAuthトークンで、Composerを使用してアプリケーションを構築および再構築する際のGitHub APIのレート制限エラーを回避するために使用されます。レート制限エラーが発生した場合は、GitHubの指示に従ってパーソナルアクセストークンを作成してください。

php_executable: php

PHP実行可能ファイルの名前またはフルパスです。この変数を上書きしない場合、デフォルトでphpとなります。

Composer 1を使用する

プロジェクトがComposer 2をサポートするようにアップグレードする間、Composer 1を実行するのが役立つ場合があります。その場合は、次の変数を設定します：

composer_version_branch: ''
composer_version: '1.10.12'

依存関係

なし（ただし、PHPがインストールされていることを確認してください。geerlingguy.phpロールを推奨します）。

例プレイブック

- hosts: servers
  roles:
    - geerlingguy.composer

プレイブックが実行された後、composerは/usr/local/bin/composerに配置されます（この場所は設定可能）、通常のシステムアカウントからアクセスできます。

ライセンス

MIT / BSD

作者情報

このロールは2014年にJeff Geerlingによって作成されました。彼はAnsible for DevOpsの著者です。