PHP 接口实现错误：方法签名不兼容的完整解决方案

当类实现接口时，所有 public 方法的参数列表（数量、类型、顺序）必须与接口中完全一致，否则会触发“Method is not compatible”错误。本文详解根本原因、修复步骤及最佳实践。

当类实现接口时，所有 public 方法的参数列表（数量、类型、顺序）必须与接口中完全一致，否则会触发“Method is not compatible”错误。本文详解根本原因、修复步骤及最佳实践。

在 PHP 里，接口（interface）本质上就是一份契约（contract）：它会明确约束实现类到底必须提供哪些方法，以及这些方法的完整签名。这里说的签名，不只是方法名而已，还包括返回类型、参数个数、参数类型（PHP 7.4+ 已支持参数类型声明），以及参数名称（虽然参数名本身不参与类型检查，但 IDE 和静态分析工具，比如 Intelephense，通常也会检查是否保持一致）。所以，你碰到的这个报错：

Method 'Calculator::getNpsScore()' is not compatible with method 'NpsCalculatorContract::getNpsScore()'

问题的根子就在这里：接口里的 getNpsScore() 明确定义成了无参方法（public function getNpsScore(): int;），但到了 Calculator 类里，你实际实现的却是一个带三个参数的版本（getNpsScore($promoters, $detractors, $responses)）。这两者看着只是“参数多了几个”，本质上却已经不再是同一个方法契约。按照 PHP 的 LSP（里氏替换原则），子类方法签名必须和父接口或父类保持协变兼容，参数可以减少（通常通过默认值实现），但不能额外增加，也不能随意改类型；一旦把参数加上去，这就属于逆变（contra variance），会直接破坏原有契约。

✅ 正确修复方案：统一签名，复用内部状态

接口方法不应重复传入 $responses 等数据——它们已在构造时注入，应作为类属性复用。修改核心逻辑如下：

1. 修正接口方法签名：所有 getter 方法不接收参数，仅依赖 $this->responses；
2. 修正类实现：移除所有方法的冗余参数，改用 $this->responses；
3. 补全构造函数类型提示：__construct(array $responses) 并赋值给属性；
4. 添加属性声明（推荐）：明确 $responses 类型，提升可读性与 IDE 支持。

✅ 修复后的完整代码：

responses = $responses;
}

public function getNpsScore(): int
{
$promoters = $this->getPromoterCount();
$detractors = $this->getDetractorCount();
$total = $this->getTotalResponseCount();

if ($total === 0) {
return 0;
}

$score = (($promoters - $detractors) / $total) * 100;
return (int) round($score); // 符合接口注释“rounded to nearest integer”
}

public function getA verageScore(): float
{
if (empty($this->responses)) {
return 0.0;
}
return round(array_sum($this->responses) / count($this->responses), 1);
}

public function getPromoterCount(): int
{
return count(array_filter($this->responses, fn($v) => $v === 9));
}

public function getPassiveCount(): int
{
return count(array_filter($this->responses, fn($v) => $v === 7 || $v === 8));
}

public function getDetractorCount(): int
{
return count(array_filter($this->responses, fn($v) => $v responses);
}
}

⚠️ 关键注意事项

• 不要在接口中为 getter 添加参数：这违背封装原则，也破坏了“一次注入、多次使用”的设计意图；
• 构造函数必须匹配接口声明：public function __construct(array $responses) —— 注意 array 类型提示不可省略；
• 空数组安全处理：在 getNpsScore() 和 getA verageScore() 中添加 if (empty(...)) 防止除零错误；
• round() 与类型转换：getNpsScore() 返回 int，需显式 round() 后 (int) 转换，确保符合 : int 声明；
• 避免 global 或外部变量：如问题中尝试的 global $responses，这会破坏面向对象设计，且无法解决签名不匹配问题。

✅ 验证示例

$responses = [9, 9, 7, 5, 10, 8, 4, 9];
$calc = new Calculator($responses);

echo "NPS: {$calc->getNpsScore()}n"; // e.g., 25
echo "A vg: {$calc->getA verageScore()}n"; // e.g., 7.6
echo "Promoters: {$calc->getPromoterCount()}n"; // 3

遵循以上规范，即可彻底消除 “Method is not compatible” 错误，并构建出类型安全、可维护的 NPS 计算器组件。