composer require php-coupling 失败是因为该名称未在 packagist 注册为有效包，它并非标准 composer 包，而是基于 php-parser 的自研 cli 工具；推荐改用 phpmetrics 或 phpstan 组合进行耦合度分析。
PHP-Coupling 不是 Packagist 上的公开包，直接 composer require 会失败——它不是一个标准 Composer 包，而是由 PHP-Parser 和自定义分析逻辑构成的 CLI 工具，需手动集成或改用替代方案。
为什么 composer require php-coupling 失败
执行 composer require php-coupling 时，Composer 会去 Packagist 搜索该包名，但 php-coupling 并未注册为官方包（截至 2026 年 6 月）。常见报错：
Could not find package php-coupling in a version matching "dev-main"
这不是你网络或镜像问题，而是根本不存在这个包名。部分教程提到的 php-coupling 实际指向非标准仓库、个人 fork 或已废弃项目（如早期 GitHub 上的 sebastianbergmann/php-coupling，早已归档）。
替代方案：用 phpstan + phpstan-deprecation-rules 或 phpmetrics
检测类间耦合度的主流做法不是靠一个叫 php-coupling 的库，而是组合静态分析工具：
-
phpstan/phpstan：通过扩展规则识别高扇出（high fan-out）、循环依赖等耦合信号 -
phpstan/extension-installer+phpstan-deprecation-rules：可自定义“禁止某类调用某命名空间”的耦合约束 -
phpmetrics/phpmetrics：生成含afferent coupling (Ca)、efferent coupling (Ce)的报告，数值越低耦合越松散
安装推荐组合：
composer require --dev phpmetrics/phpmetrics:^3.0
然后运行：
vendor/bin/phpmetrics --report-html=reports/metrics ./src
报告中 “Coupling” 表格即包含每个类的 Ca/Ce 值，可直接用于评估。
如果非要基于 PHP-Parser 自建耦合检测器
你得自己写分析逻辑，而不是装一个现成包。步骤如下：
- 先装底层依赖：
composer require --dev php-parser/php-parser:^5.0 - 写一个遍历 AST 的脚本，统计
MethodCall、StaticCall、New_节点中目标类名出现频次 - 注意：
php-parser不自带耦合度算法，所有指标（如 Ca/Ce）需自行实现计数逻辑和归一化 - 别漏掉
use语句导入的类——它们不产生运行时耦合，但影响可维护性，是否计入取决于你的定义
这类脚本通常只有几百行，但调试 AST 遍历路径容易出错，比如忽略 trait 中的方法调用、或把字符串字面量误判为类名。
真正难的不是“装哪个包”，而是明确定义你要测的耦合类型：是编译期依赖？运行时实例化？还是接口契约滥用？不同定义对应完全不同的检测逻辑，phpmetrics 给的是通用指标，自研脚本才可能贴合你团队的架构约束。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
