php接口必须用interface关键字声明,它是一套只定义行为契约的语法结构,不包含属性、函数体、构造方法,仅支持public抽象方法和常量,支持多重实现与类型约束。

PHP接口必须用 Interface 关键字声明,不能用 class 或 trait
PHP接口不是类的变体,也不是抽象类的简化版——它是一套契约,只定义“能做什么”,不涉及“怎么做”。一旦写成 class,哪怕只含抽象方法,就失去了接口的语义和多重实现能力。
-
interface声明后,所有方法默认是public且abstract,不能加private、protected或final - 接口里不能有属性(
$Property),但可以有常量(const VERSION = '1.0') - 从 PHP 8.0 起支持泛型接口,但需配合
extends约束类型,比如interface Repository<t></t>,否则会报Parse Error: syntax error
接口方法不能带函数体,连空花括号都不行
这是新手最常踩的坑:在接口里写 function doSomething() {} 或 function doSomething(): void { },PHP 直接报 Parse error: interface function cannot contain body。
- 正确写法只有签名:例如
function save(Array $data): bool; - 返回类型声明是可选的,但一旦写了,实现类必须严格匹配(包括
void和?String这类联合类型) - PHP 7.4+ 支持箭头函数语法?不行。接口里连普通函数体都不允许,更别说箭头函数
一个类用 implements 实现多个接口时,方法顺序和命名必须完全一致
PHP 不检查方法实现顺序,但会逐个校验签名是否匹配。如果两个接口都定义了 find(int $id),而你实现时写成 find(string $id),运行时报 Fatal error: Declaration of ... must be compatible with ...。
- 参数名可以不同(
$id和$uid都行),但类型、数量、可选性必须一致 - 如果接口 A 要求
find(int $id): ?User,接口 B 要求find(int $id): Model,而User并未继承Model,则无法同时实现这两个接口 - 多个
implements用逗号分隔:class UserRepo implements Readable, Writable, Cacheable
接口不能被实例化,也不能用 new 创建对象
写 $i = new MyInterface(); 会立刻触发 Fatal error: Cannot instantiate interface。接口只用于约束,不是容器或工厂。
立即学习“PHP免费学习笔记(深入)”;
- 想动态获取实现类?得靠依赖注入容器或手动映射,比如
$container->get(RepositoryInterface::class) -
instanceof可以安全用于判断:if ($obj instanceof LoggerInterface) { ... } - 别试图给接口加构造函数——语法上就不允许,
__construct()在接口里是非法的
接口本身不参与运行时逻辑,但它像交通标线:看不见引擎怎么转,但所有车都得按它走。类型提示、ide跳转、静态分析全靠它撑着,漏掉一个 ? 或写错一个类型,后面就是一串兼容性报错。