PHP接口与类型兼容性：避免object类型参数的陷阱
在PHP开发中，接口定义与实现类类型不匹配常常导致“must be compatible with”错误。本文分析一个PHP接口定义和实现类中出现的此类问题，并提供解决方案。
问题：接口与实现类的类型不兼容
假设我们定义了一个IAdminController接口，其中save方法的参数类型为object：
立即学习“PHP免费学习笔记（深入）”；
interface IAdminController
{
// ...其他方法...
public function save(object $request): array;
// ...其他方法...
}
而实现类中save方法的参数类型为AdminRequest：
class AdminController implements IAdminController
{
public function save(AdminRequest $request): array
{
// ...方法体...
}
}
尽管AdminRequest是object的子类（所有类都隐式继承自object），运行时仍然报错“must be compatible with”。 即使gettype($adminRequest)返回object，依然无法通过类型检查。
原因分析与解决方案
使用object作为方法参数类型并非最佳实践。虽然所有类都继承自object，但这种定义过于宽泛，缺乏类型安全保障。PHP解释器在类型检查时，会严格验证参数的具体类型是否与接口定义完全匹配。object作为参数类型没有对具体类型进行约束，即使AdminRequest是对象，它也不符合接口定义中指定的object类型。
更优的方案是使用更具体的类型作为接口参数。 如果AdminRequest、UserRequest等类都继承自Laravel的Request类，则在接口中将save方法的参数类型定义为\Illuminate\Http\Request：
interface IAdminController
{
// ...其他方法...
public function save(\Illuminate\Http\Request $request): array;
// ...其他方法...
}
这样，所有继承自\Illuminate\Http\Request的类都可以作为save方法的参数，解决了类型不兼容问题。 这利用了PHP类型系统的协变特性，允许子类参数签名比父类更宽松。
重要提示：
- 在PHP 7.2之前的版本中，
object作为方法签名类型存在更多限制。虽然PHP 7.2及以上版本支持object作为参数类型，但仍然不推荐在接口定义中使用。 - 使用更具体的类型可以提高代码的可读性、可维护性和类型安全性。
- 如果必须使用
object进行类型检查，可在方法内部使用is_a()函数进行显式类型检查，但这会降低代码的类型安全性，并且降低可读性。 尽量避免这种做法。
通过选择更具体的类型定义接口，可以有效避免类型不兼容错误，提高代码质量。
