Composer不会直接安装phar文件，而是通过bin配置或脚本自动化下载管理；常见误区是认为其能像普通库一样解析phar；可通过composer.json的bin-dir、scripts或插件如bamarni/composer-bin-plugin实现集成。
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
来执行它。这种方式给予了你极大的灵活性，但需要自己编写下载逻辑。
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
使用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
：
// 项目的 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
手动触发。
例如，如果你需要一个特定的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" }}
在这个例子中，我们定义了一个
download-my-custom-tool
脚本，它负责下载PHAR文件并赋予执行权限。然后，我们可以在
post-install-cmd
中调用这个脚本，确保每次项目安装后，这个工具都能自动准备好。最后，
run-tool
脚本则提供了一个方便的快捷方式来执行这个PHAR工具。自定义脚本的优点是灵活性极高，你可以编写任何shell命令或PHP脚本来完成任务，但缺点是需要自己维护这些脚本的健壮性（例如，处理下载失败、文件已存在等情况）。
无论是选择插件还是自定义脚本，它们都为Composer在PHAR工具管理上提供了强大的扩展能力，让我们的开发工作流更加顺畅和自动化。选择哪种方式，通常取决于项目的具体需求、团队对新依赖的接受程度以及所需功能的复杂性。
以上就是composer如何安装phar归档包的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/152105.html
微信扫一扫 
支付宝扫一扫 
