shaneholloman.composer
Ansible角色:composer
在任何Linux或UNIX系统上安装Composer,PHP依赖管理工具。
要求
- 应该安装并正常工作
php
(版本5.4及以上,可以使用shaneholloman.php
角色进行安装)。 - 应该安装并正常工作
git
(可以使用shaneholloman.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
和release
的字典项,例如- { 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;推荐使用shaneholloman.php
角色)。
示例剧本
- hosts: servers
roles:
- shaneholloman.composer
剧本运行后,composer
将放在/usr/local/bin/composer
(此位置可配置),并将通过正常系统账户访问。
许可
不许可
作者信息
此角色创建于2023年。