Composer不支持直接安装.phar文件，因其仅管理含composer.json的PHP包；正确方式是通过composer global require安装提供bin入口的工具包，或手动下载执行.phar文件。
Composer 本身不支持直接安装 .phar 文件，它只管理 PHP 包（composer.json 定义的依赖）。所谓“用 Composer 安装 Phar 工具”，实际是通过 composer global require 安装提供 bin 入口的包，其内部可能打包为 Phar —— 但你从不手动下载或执行 .phar 文件。
为什么不能 composer require xxx.phar
Composer 的 require 命令只接受合法的包名（如 phpunit/phpunit），并从 Packagist 或自定义仓库拉取带 composer.json 的源码/zip 包。直接写 xxx.phar 会报错：
Could not find a matching version of package xxx.phar.
这是因为：.phar 是构建产物，不是 Composer 包；Packagist 不索引裸 Phar 文件；Composer 无解析、校验、重定位 Phar 的机制。
正确方式：用 composer global require 装带 bin 的工具包
主流命令行工具（如 phpstan、psalm、larastan）都以 Composer 包形式发布，其 composer.json 中声明了 "bin" 字段，安装后自动软链到 ~/.composer/vendor/bin/（或 Windows 下对应路径）。
- 确保已配置全局 bin 目录到
$PATH（首次运行composer global install后提示过） - 运行
composer global require phpstan/phpstan，完成后即可直接执行phpstan - 该包内部可能用 Phar 打包 CLI 入口，但你完全感知不到 —— Composer 自动处理了 autoload 和 bin 注册
如果只有独立 .phar 文件（比如 php-cs-fixer.phar）怎么办？
这时根本不用 Composer：下载、加执行权限、放系统路径即可。这是最轻量也最可控的方式。
- 用
curl -L https://cs.symfony.com/download/php-cs-fixer-v3.phar -o php-cs-fixer下载 chmod +x php-cs-fixer- 移入
/usr/local/bin/或~/.local/bin/（确保该目录在$PATH中） - 之后就能直接运行
php-cs-fixer --version
注意：.phar 文件需用 PHP CLI 运行，且部分 Phar 会检查签名（如 Symfony 官方 PHAR），不可随意修改内容或重命名。
常见陷阱与验证点
很多人卡在“装了却找不到命令”，问题通常不在 Composer，而在环境路径或权限。
-
composer global show查看是否真装上了目标包（不是拼错名字，比如phpunitvsphpunit/phpunit） -
echo $PATH确认~/.composer/vendor/bin（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows）在其中 -
which phpstan（macOS/Linux）或where phpstan（Windows）确认命令是否可定位 - 全局安装失败时，先运行
composer global diagnose检查配置和网络
真正需要警惕的是混用两种方式：既用 Composer global 装了 phpstan，又手动下载 phpstan.phar 放进 PATH —— 容易因版本不一致导致行为差异，且调试困难。
