shaneholloman.composer

Ansible角色:composer

CI

在任何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)。如果想要全局安装任何包,请添加一个包含包namerelease的字典项,例如- { name: phpunit/phpunit, release: "4.7.*" }release是可选的,默认为@stable

composer_add_to_path: true

如果为true,并且配置了任何composer_global_packagescomposer_home_path中的vendor/bin目录将添加到系统的默认$PATH(对所有用户)。

composer_project_path: /path/to/project

Composer项目的路径。

composer_add_project_to_path: false

如果为true,并且配置了composer_project_pathcomposer_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年。

关于项目

Composer PHP Dependency Manager

安装
ansible-galaxy install shaneholloman.composer
许可证
unlicense
下载
6.1k
拥有者