README

=======

composer-tool-installer-plugin

使用 composer 安装项目需求

如果你的 composer 项目需要一些额外的二进制文件（如自带的 Go-Lang 二进制文件）或特殊的测试工具集（PHPUnit、PhantomJS、...）或一些 QA 控制工具（phpcs、phpmd、security-checker、...），则此插件是正确的选择。

使用此插件，您可以在项目的 composer.json 文件中管理所有这些内容。这样，您可以确保项目中的所有开发者都能获得所需文件及其所需版本，可选带有 GPG 签名或 Pub-Key 验证。

所有所需文件都将保存在 composer 二进制目录 中。

此插件深受 tooly-composer-script 的启发 - 使用 composer 进行 PHAR 管理。

需求

• PHP >= 5.6
• composer

安装

composer require tm/composer-tool-installer-plugin

或者如果您想在多个项目中使用它

composer global require tm/composer-tool-installer-plugin

用法

composer.json 模式中的 "extra" 部分，在此插件中使用。其描述在这里。

要添加一个需求（工具或二进制文件），您可以手动将其添加到项目的 composer.json 文件中（见下面章节），或者您可以使用 composer CLI。每次您使用命令时，给定的值都会保存在 composer 缓存目录中，并在下次使用时提出。

composer tool-installer:install

如果您想查看当前配置，只需运行

composer tool-installer:show

配置

您可以在这里找到示例配置。完整的配置选项在 wiki 中描述。

示例

• [PHPUnit] 带有 GPG 验证

{
    ...
    "extra": {
        "tools": {
            "phpunit": {
                "url": "https://phar.phpunit.de/phpunit-5.6.1.phar",
                "sign-url": "https://phar.phpunit.de/phpunit-5.6.1.phar.asc",
            }
        }
    }
    ...
}

• [humhub] 带有所需的 pub-key

{
    ...
    "extra": {
        "tools": {
            "humbug": {
                "url": "https://github.com/padraic/humbug/releases/download/1.0.0-alpha2/humbug.phar",
                "key-url": "https://github.com/padraic/humbug/releases/download/1.0.0-alpha2/humbug.phar.pubkey",
            }
        }
    }
    ...
}

• [own binary] 不仅用于开发

{
    ...
    "extra": {
        "tools": {
            "my-binary": {
                "url": "https://my-package-server/my-binary.bin",
                "only-dev": false
            }
        }
    }
    ...
}

贡献

有关如何贡献的信息，请参阅 CONTRIBUTING.md。