composer如何安装phar归档包-composer-PHP中文网

Composer不会直接安装phar文件，而是通过bin配置或脚本自动化下载管理；常见误区是认为其能像普通库一样解析phar；可通过composer.json的bin-dir、scripts或插件如bamarni/composer-bin-plugin实现集成。

composer如何安装phar归档包

Composer本身并不会像处理常规PHP依赖那样，直接“安装”一个phar归档包到你的

vendor

登录后复制

目录里去。它的核心是管理项目的源代码依赖，而phar文件通常是预编译的二进制可执行文件。所以，如果你想让Composer“处理”一个phar包，我们通常是在利用Composer的脚本能力或者它的路径管理机制，让它帮助我们更好地集成或使用这些工具，而不是直接把它当作一个可解析的PHP库来安装。

解决方案

要让Composer与phar归档包协同工作，我们主要有几种思路，但核心都不是Composer直接“解压”或“安装”phar。更多的是通过Composer的

bin

登录后复制

配置，或者利用它的脚本功能来下载和管理这些独立的工具。

作为项目依赖的命令行工具（最常见）： 很多PHP工具，比如PHPUnit、php-cs-fixer、PHPStan等，虽然最终可能以phar形式运行，但它们本身是作为Composer包发布的。当你
```
require
```
登录后复制
这些包时，Composer会把它们的源代码（或预编译的phar版本，如果包提供了）下载到
```
vendor
```
登录后复制
目录。更重要的是，如果这些包在
```
composer.json
```
登录后复制
中定义了
```
bin
```
登录后复制
入口，Composer会自动在
```
vendor/bin
```
登录后复制
目录下创建指向这些工具的符号链接。这样，你就可以直接通过
```
vendor/bin/phpunit
```
登录后复制
或
```
vendor/bin/php-cs-fixer
```
登录后复制
来执行它们，而无需手动管理phar文件。
```
{
    "require-dev": {
        "phpunit/phpunit": "^9.5",
        "friendsofphp/php-cs-fixer": "^3.0"
    },
    "config": {
        "bin-dir": "bin" // 可选，将bin目录移到项目根目录
    }
}
```
登录后复制
运行
```
composer install
```
登录后复制
后，你会在
```
vendor/bin
```
登录后复制
（或你配置的
```
bin
```
登录后复制
目录）中找到对应的可执行文件。
通过Composer脚本下载和管理独立的phar工具： 如果一个phar工具没有以Composer包的形式发布，或者你只是想在项目中使用一个特定的phar版本，你可以利用Composer的
```
scripts
```
登录后复制
功能来自动化下载过程。
```
{
    "scripts": {
        "post-install-cmd": [
            "test -f tools/mytool.phar || curl -L https://example.com/mytool.phar -o tools/mytool.phar"
        ],
        "post-update-cmd": [
            "test -f tools/mytool.phar || curl -L https://example.com/mytool.phar -o tools/mytool.phar"
        ],
        "run-mytool": "php tools/mytool.phar"
    }
}
```
登录后复制
这里，我们在
```
post-install-cmd
```
登录后复制
和
```
post-update-cmd
```
登录后复制
中添加了一个检查并下载
```
mytool.phar
```
登录后复制
的命令。
```
test -f
```
登录后复制
用于检查文件是否存在，避免重复下载。然后你可以通过
```
composer run-mytool
```
登录后复制
来执行它。这种方式给予了你极大的灵活性，但需要自己编写下载逻辑。
使用Composer插件（较少见但强大）： 有一些Composer插件专门用于处理phar文件，例如
```
bamarni/composer-bin-plugin
```
登录后复制
。这些插件可以让你在
```
composer.json
```
登录后复制
中声明你希望安装的phar工具，然后插件会负责下载和管理它们，通常也会在
```
vendor/bin
```
登录后复制
中创建符号链接。这种方式比手动脚本更规范，但需要引入额外的插件依赖。

总的来说，Composer不会直接“安装”一个phar文件到你的

vendor

登录后复制

目录，因为它不是一个常规的PHP库。它更多的是作为一个协调者，帮助你管理那些以phar形式存在的工具，无论是通过它自己的

bin

登录后复制

机制，还是通过自定义脚本，甚至是借助第三方插件。

Composer管理PHAR工具的常见误区是什么？

我发现很多初学者，包括我自己刚接触时，都容易对Composer如何处理PHAR文件产生一些误解。最常见的一个误区就是，认为Composer能够像安装

monolog/monolog

登录后复制

那样，直接把一个独立的

.phar

登录后复制

文件下载下来，然后“安装”到

vendor

登录后复制

目录，甚至期望它能像解压zip包一样把phar内部的代码暴露出来。但实际上，Composer的核心机制是基于

composer.json

登录后复制

中定义的包名和版本，从Packagist或VCS仓库拉取源代码，然后构建

vendor

登录后复制

目录和自动加载器。

PHAR文件，全称PHP Archive，它是一个将多个PHP文件打包成一个可执行文件的格式，它更像是一个“自包含”的二进制文件，而不是一个需要Composer去解析和管理其内部依赖的源代码库。当你

require

登录后复制

一个包，比如

phpunit/phpunit

登录后复制

，Composer安装的是PHPUnit的源代码包，这个包里可能包含了构建PHAR的脚本，或者它本身就是一个提供了

bin

登录后复制

入口的工具包，而这个

bin

登录后复制

入口可能指向一个预构建的PHAR文件，或者是一个PHP脚本来启动PHPUnit。Composer所做的，是确保这个包的依赖都到位，并把它的可执行脚本（如果定义了）链接到

vendor/bin

登录后复制

。

所以，如果你有一个独立的

mytool.phar

登录后复制

文件，它没有对应的

composer.json

登录后复制

发布，那么Composer是不会直接“安装”它的。你不能简单地在

composer.json

登录后复制

里写

"require": {"mytool/mytool": "1.0.0"}

登录后复制

，然后指望Composer能神奇地找到并安装这个phar文件。你需要做的，是告诉Composer如何获取这个文件，以及如何让它变得可用，这通常需要通过自定义脚本或特定的插件来实现。

如何通过Composer项目配置来使用PHAR工具？

利用Composer的项目配置来集成PHAR工具，主要是围绕着

bin

登录后复制

目录的自动链接功能和

scripts

登录后复制

命令的自动化执行。这两种方式能让你的PHAR工具管理变得非常顺手，尤其是在团队协作和CI/CD环境中。

首先，利用

bin

登录后复制

目录自动链接。当一个Composer包提供了命令行工具，并且在它的

composer.json

登录后复制

中定义了

bin

登录后复制

字段，例如：

// 包的 composer.json
{
    "name": "somevendor/my-cli-tool",
    "bin": ["bin/my-cli-tool"]
}

登录后复制

当你将这个包作为依赖添加到你的项目

composer.json

登录后复制

中并运行

composer install

登录后复制

后，Composer会在你的项目根目录下的

vendor/bin

登录后复制

目录中创建一个指向

vendor/somevendor/my-cli-tool/bin/my-cli-tool

登录后复制

的符号链接。这意味着你可以在项目根目录直接运行

vendor/bin/my-cli-tool

登录后复制

来执行这个工具。如果你觉得

vendor/bin

登录后复制

路径太长，可以在你的项目

composer.json

登录后复制

中配置

config.bin-dir

登录后复制

：

ProfilePicture.AI

在线创建自定义头像的工具

查看详情

// 项目的 composer.json
{
    "require-dev": {
        "somevendor/my-cli-tool": "^1.0"
    },
    "config": {
        "bin-dir": "tools" // 这样链接就会创建在项目根目录的 "tools/" 目录下
    }
}

登录后复制

现在，你就可以通过

tools/my-cli-tool

登录后复制

来执行这个工具了。这种方式非常优雅，因为它把工具的安装和路径管理都交给了Composer。

其次，通过

scripts

登录后复制

命令自动化。对于那些没有作为Composer包发布的独立PHAR工具，或者你需要下载特定版本的PHAR文件，

scripts

登录后复制

字段就派上用场了。你可以定义一些命令，让Composer在特定的生命周期事件（如

post-install-cmd

登录后复制

、

post-update-cmd

登录后复制

）或者通过自定义命令来执行它们。

比如，你想在项目安装或更新后，自动下载一个名为

phpmetrics.phar

登录后复制

的静态分析工具：

{
    "scripts": {
        "post-install-cmd": [
            "@php -r \"copy('https://phpmetrics.org/phpmetrics.phar', 'bin/phpmetrics.phar');\""
        ],
        "post-update-cmd": [
            "@php -r \"copy('https://phpmetrics.org/phpmetrics.phar', 'bin/phpmetrics.phar');\""
        ],
        "analyze": "php bin/phpmetrics.phar"
    }
}

登录后复制

这里，我们使用了

@php -r "..."

登录后复制

来执行一段PHP代码，它会从指定的URL下载

phpmetrics.phar

登录后复制

并保存到

bin/

登录后复制

目录下。

登录后复制

符号在Composer脚本中表示即使命令失败也不中断后续脚本执行。然后，我们定义了一个

analyze

登录后复制

的自定义脚本，方便我们通过

composer analyze

登录后复制

来运行这个工具。这种方法虽然需要你手动管理下载逻辑，但它把所有工具的集成配置都集中在

composer.json

登录后复制

中，使得项目环境的搭建和维护变得非常一致和自动化。

Composer插件或自定义脚本在PHAR管理中的作用？

当Composer的内置机制不足以满足我们对PHAR工具的复杂管理需求时，Composer插件和自定义脚本就成了我们的得力助手。它们允许我们突破Composer处理常规依赖的范畴，将更灵活、更个性化的PHAR工具集成方案引入到项目中。

Composer插件的作用： Composer插件是扩展Composer核心功能的强大方式。对于PHAR管理而言，一些插件就是为了解决特定痛点而生。例如，

bamarni/composer-bin-plugin

登录后复制

这个插件，它的核心思想是让你可以在

composer.json

登录后复制

中声明你想要安装的PHAR工具，而不用把它们作为常规的Composer包依赖。它会为你处理下载、版本管理，甚至是在

vendor/bin

登录后复制

（或自定义的bin目录）中创建符号链接，让你像使用普通Composer安装的工具一样方便。

比如，你可能想使用一个PHAR工具，但它没有在Packagist上发布，或者你希望它独立于你的项目依赖，不污染

vendor

登录后复制

目录。通过这样的插件，你可以在

composer.json

登录后复制

中添加类似这样的配置：

{
    "require": {
        "bamarni/composer-bin-plugin": "^1.8"
    },
    "extra": {
        "bin-install": [
            {
                "name": "php-cs-fixer",
                "url": "https://cs.symfony.com/download/php-cs-fixer-v3.phar",
                "version": "v3"
            },
            {
                "name": "phpmetrics",
                "url": "https://phpmetrics.org/phpmetrics.phar",
                "version": "latest"
            }
        ]
    }
}

登录后复制

安装插件后，运行

composer bin:install

登录后复制

，插件就会根据

bin-install

登录后复制

的配置去下载对应的PHAR文件，并把它们放到一个专门的bin目录下（通常是

vendor/bin

登录后复制

或你配置的其他路径），并创建可执行的符号链接。这种方式比手动编写脚本更规范，也更容易维护，因为它将PHAR工具的管理逻辑封装在了插件中。

自定义脚本的作用： 对于更简单、更直接的需求，或者当你不想引入额外插件依赖时，Composer的自定义脚本功能是管理PHAR工具的瑞士军刀。我们可以在

composer.json

登录后复制

的

scripts

登录后复制

部分定义各种命令，这些命令可以在Composer的生命周期事件中自动执行，或者通过

composer run-script <script-name>

登录后复制

手动触发。

例如，如果你需要一个特定的PHAR工具，但它的下载URL可能会变化，或者你需要做一些下载前的校验、下载后的权限设置等操作，自定义脚本就能派上用场。

{
    "scripts": {
        "download-my-custom-tool": [
            "echo 'Downloading custom tool...'",
            "curl -sSL -o bin/my-custom-tool.phar https://my-custom-tool.com/latest/tool.phar",
            "chmod +x bin/my-custom-tool.phar",
            "echo 'Custom tool downloaded and made executable.'"
        ],
        "post-install-cmd": [
            "@download-my-custom-tool" // 在安装后自动下载
        ],
        "run-tool": "php bin/my-custom-tool.phar --version"
    }
}

登录后复制

在这个例子中，我们定义了一个