PHP 继承方法类型兼容 怎样处理

PHP 子类重写父类方法时报类型不兼容，通常不是“类型写得越严格越好”，而是破坏了父类方法原本允许的调用范围。处理顺序是：先对比可见性和参数列表，再检查参数逆变、返回值协变，最后单独核对构造方法、private 方法以及内部类的返回类型提示。

官方资料：https://www.php.net/manual/en/oop5.basic.php

先把“方法类型兼容”拆成五项

不要只盯着报错里的某一个类型。一个可重写的方法至少要同时看可见性、参数数量、参数默认值、参数类型和返回类型。父类公开的方法仍要能被外部调用，因此子类不能把 public 收紧为 protected；父类允许调用者只传一个参数时，子类也不能突然要求更多必选参数。

这些规则服务于可替换性：把子类对象放到原来使用父类对象的位置，原调用代码仍然应该成立。构造方法和 private 方法是重要例外，不能拿它们直接推导普通 public/protected 方法的规则。

参数要放宽，返回值可以收窄

参数遵循逆变，子类应至少接受父类调用方可能传入的范围；返回值遵循协变，子类可以承诺一个更具体的结果。例如父类接收 Animal，子类接收 Animal 仍兼容，接收 Cat 就可能拒绝原本合法的 Dog。反过来，父类返回 Animal，子类返回 Cat 是更具体的承诺。

如果子类只处理 Cat，就不要硬改写这个父类方法；可以新增一个只接收 Cat 的方法，或重新设计父类抽象边界。靠删除参数类型来“让它通过”也要谨慎，因为这会扩大实现范围，却可能掩盖领域模型本身不清楚的问题。

可选参数和可见性怎样改才安全

父类的必选参数可以在子类中变成可选参数，因为旧调用仍然有效；子类也可以在末尾追加可选参数。下面的 $limit 不影响只传一个参数的旧调用。可见性则只能放宽，不能让调用方失去原来的访问权限。

实际项目里还要检查命名参数调用：PHP 8 支持按参数名传值，接口或父类的参数名也可能成为调用约定的一部分。即使类型通过，随意改名仍可能破坏调用方。

PHP 8.1 内部方法的返回类型提示怎么处理

升级到 PHP 8.1 之后，许多内部类方法开始带有 tentative return type。子类没有声明返回类型，或声明了不兼容类型，可能出现弃用提示。优先方案是让子类声明与父类兼容的真实返回类型；确实需要兼容多个旧版本时，才把 #[\ReturnTypeWillChange] 作为临时过渡，并把后续移除它列入升级清单。

这个属性不是让错误类型永久合法，也不是关闭所有类型检查。对用户自定义父类和接口，仍应直接修正签名；对内部类继承，则根据目标 PHP 版本、依赖包兼容范围和真实返回语义决定迁移顺序。

发布前用这张清单做回归

1. 找出所有 extends 和 implements，逐个对比被重写的方法。
2. 确认子类没有新增必选参数，参数类型没有收窄，返回类型没有变宽。
3. 确认 public、protected 的可见性没有收紧，并检查 PHP 8 命名参数带来的参数名兼容。
4. 单独列出构造方法、private 方法和内部类方法，避免把例外混进普通规则。
5. 在目标 PHP 版本运行现有测试，把 Fatal error、Deprecated 和 TypeError 分开处理。

相关问题

子类能删除父类的参数类型吗？

通常可以视为放宽输入范围，但要确认实现内部仍能安全处理更宽的值；删除类型不是修复领域模型的替代方案。

返回类型能从类改成 mixed 吗？

一般不行，这是把返回承诺变宽，可能违反协变规则。应返回父类允许的类型，或重新设计抽象方法。

为什么 PHP 8.1 只出现 Deprecated 而不是 Fatal error？

常见原因是继承内部方法时触发 tentative return type 提示。先按官方父类签名补齐返回类型，跨版本过渡才考虑 ReturnTypeWillChange。

方法兼容的核心不是让子类“看起来更严格”，而是保持父类调用方的合法空间。先检查输入边界，再检查输出承诺，最后结合版本和接口调用方式做回归，通常比逐条试错更快。