本文详解 php 中接口方法签名一致性原则，解决因子类方法参数类型窄化（如用具体类替代接口）导致的“declaration must be compatible”致命错误，并提供可扩展、符合 lsp 的仓储层实现方案。
本文详解 php 中接口方法签名一致性原则，解决因子类方法参数类型窄化（如用具体类替代接口）导致的“declaration must be compatible”致命错误，并提供可扩展、符合 lsp 的仓储层实现方案。
在 PHP 面向对象开发中，当实现一个接口时，子类方法的签名（包括参数类型、返回类型和异常声明）必须严格与接口定义保持一致——这是 PHP 类型系统强制执行的契约规则，也是里氏替换原则（LSP）的核心体现。你遇到的错误：
Declaration of ShirtOrderRepository::find(ShirtOrder $shirtOrder) must be compatible with RepositoryInterface::find(IEntity $entity)
根本原因在于：ShirtOrderRepository 试图将接口要求的宽泛类型 IEntity，窄化为具体实现类 ShirtOrder。PHP 不允许这种“逆变参数类型收紧”，因为这会破坏多态调用的安全性——外部代码若按 RepositoryInterface 调用 find()，传入任意 IEntity 实现（如 Customer 或 Invoice），而 ShirtOrderRepository::find() 却只接受 ShirtOrder，必然导致运行时错误。
✅ 正确做法是：严格遵循接口声明，所有实现方法的参数类型必须与接口完全一致：
class ShirtOrderRepository implements RepositoryInterface {
protected $db;
public function __construct(DatabaseInterface $db) {
$this->db = $db;
}
// ✅ 正确：参数类型与接口一致 —— IEntity
public function find(IEntity $entity) {
$this->db->find($entity);
}
public function save(IEntity $entity) {
$this->db->save($entity);
}
public function remove(IEntity $entity) {
$this->db->remove($entity);
}
}⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
-
不要尝试在方法体内做类型断言或强制转换（如
if (!$entity instanceof ShirtOrder) throw ...）——这违背了接口抽象意义，也未解决设计缺陷； - 若需针对不同实体提供差异化逻辑，应在运行时通过
$entity->getTableName()等接口方法动态判断，而非编译期类型限制； - 如未来需支持泛型仓储（如
Repository<t extends ientity></t>），PHP 8.0+ 可结合模板注释（PHPDoc）配合静态分析工具（如 PHPStan）增强类型安全，但运行时仍必须使用IEntity作为参数类型； -
DatabaseInterface中的方法也应保持IEntity参数类型，确保底层数据库操作层同样具备实体无关性。
? 总结：接口是契约，不是建议。RepositoryInterface::find(IEntity) 定义的是“任何实体均可被查找”的能力；ShirtOrderRepository 的职责是以 ShirtOrder 的方式实现该能力，而非重新定义能力范围。保持参数类型一致，既是语法要求，更是构建可维护、可扩展领域架构的基石。
