本文详解 php 中“method is not compatible with interface”错误的根本原因与修复方法，重点解决接口方法声明与类中实现方法参数/返回值不一致导致的契约违反问题，并提供完整可运行的 nps 计算器重构示例。
本文详解 php 中“method is not compatible with interface”错误的根本原因与修复方法，重点解决接口方法声明与类中实现方法参数/返回值不一致导致的契约违反问题，并提供完整可运行的 nps 计算器重构示例。
在 PHP 面向对象开发中，当一个类 implements 某个接口时，PHP 要求该类必须严格遵循接口定义的方法签名——包括方法名、参数数量、参数类型（含是否可选）、参数顺序，以及返回类型（PHP 7.1+ 启用严格模式后尤其关键）。你遇到的报错：
Method 'Calculator::getNpsScore()' is not compatible with method 'NpsCalculatorContract::getNpsScore()'
根本原因在于：接口中 getNpsScore() 声明为无参数、返回 int；而你在 Calculator 类中却实现了带三个参数（$responses, $promoters, $detractors）的同名方法。这直接违反了 Liskov 替换原则和 PHP 的接口契约机制，导致类型检查失败（如 Intelephense、PHPStan 或 PHP 8+ 运行时严格模式下均会报错）。
✅ 正确做法：统一方法签名，状态由实例维护
接口方法不应重复传入 $responses 等数据——这些应作为类的私有属性，在构造时注入并复用。修改核心思路如下：
- ✅ 接口方法不接收任何参数（除
__construct外），仅依赖内部状态； - ✅ 类中将
$responses存为私有属性（如$this->responses），所有计算方法直接访问它； - ✅ 所有方法签名（参数列表 + 返回类型）必须与接口完全一致；
- ✅ 补充类型声明（
array $responses构造器参数、int|float返回类型）提升健壮性。
以下是修复后的完整、可运行代码：
立即学习“PHP免费学习笔记（深入）”；
<?php
interface NpsCalculatorContract
{
public function __construct(array $responses);
public function getNpsScore(): int;
public function getAverageScore(): float;
public function getPromoterCount(): int;
public function getPassiveCount(): int;
public function getDetractorCount(): int;
public function getTotalResponseCount(): int;
}
class Calculator implements NpsCalculatorContract
{
private array $responses;
public function __construct(array $responses)
{
// 验证输入：确保所有响应值为 1–10 的整数
foreach ($responses as $value) {
if (!is_int($value) || $value < 1 || $value > 10) {
throw new InvalidArgumentException('Each response must be an integer between 1 and 10.');
}
}
$this->responses = $responses;
}
public function getNpsScore(): int
{
$promoterCount = $this->getPromoterCount();
$detractorCount = $this->getDetractorCount();
$totalCount = $this->getTotalResponseCount();
if ($totalCount === 0) {
return 0; // 无响应时 NPS 定义为 0
}
$score = (($promoterCount - $detractorCount) / $totalCount) * 100;
return (int) round($score); // 四舍五入取整，符合接口要求
}
public function getAverageScore(): 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);
}
}
// ✅ 使用示例
$responses = [9, 10, 8, 7, 5, 3, 9, 8, 9];
$calculator = new Calculator($responses);
echo "NPS Score: {$calculator->getNpsScore()}\n"; // e.g., 33
echo "Average: {$calculator->getAverageScore()}\n"; // e.g., 7.4
echo "Promoters: {$calculator->getPromoterCount()}\n"; // 3
echo "Passives: {$calculator->getPassiveCount()}\n"; // 3
echo "Detractors: {$calculator->getDetractorCount()}\n"; // 2
echo "Total: {$calculator->getTotalResponseCount()}\n"; // 8⚠️ 关键注意事项
-
不要在接口方法中添加参数：接口定义的是“能力契约”，不是“过程调用”。若强行在接口中追加
$responses参数（如答案中建议的），虽能绕过报错，但彻底破坏封装性与可测试性——使用者每次调用都需重复传入相同数据，违背 OOP 原则。 -
构造器参数类型必须匹配：接口中声明
__construct(array $responses)，则类中必须为public function __construct(array $responses)，不可省略类型或改为mixed。 -
启用严格类型检查：在文件顶部添加
declare(strict_types=1);可提前捕获类型不匹配问题。 -
避免全局变量或
&$responses引用：如提问者尝试的global $responses或引用传递，属于反模式，破坏可维护性与单元测试能力。
通过以上重构，你的 Calculator 类真正实现了 NpsCalculatorContract 的契约：语义清晰、类型安全、易于扩展（例如后续可轻松添加缓存、日志或不同评分策略）。记住：接口是承诺，不是模板；实现是履约，不是拼凑。
