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

核心问题在于方法签名不一致。 当类实现接口时，所有 public 方法都必须严格遵守接口定义。

在 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（里氏替换原则），子类方法签名必须和父接口或父类保持协变兼容。参数可以减少（通常通过默认值实现），但不能额外增加，也不能随意改类型。

一旦把参数加上去，就会破坏原有契约，并直接导致兼容性错误。

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

接口方法不应重复传入 $responses 等数据。它们已在构造时注入，应作为类属性复用。

• 修正接口方法签名：所有 getter 方法不接收参数，仅依赖 $this->responses
• 修正类实现：移除所有方法的冗余参数，改用 $this->responses
• 补全构造函数类型提示：__construct(array $responses) 并赋值给属性
• 添加属性声明（推荐）：明确 $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 < 6));
}

public function getTotalResponseCount(): int
{
return count($this->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 计算器组件。

《夸克》非常好用的免费AI浏览器

下载APP查看