PHP接口开发与使用规范详解

PHP接口（interface）本质上是一种契约而非可实例化的类，必须由具体类通过implements实现后才能创建对象，直接new接口会导致致命错误；其方法仅支持public修饰符，禁止使用final、static、protected或private等修饰符，且PHP8.0+虽允许接口定义静态方法和常量，但静态方法需带函数体、不再属于纯契约范畴；当一个类实现多个含同名方法的接口时，这些方法的签名（参数类型、数量、顺序及返回类型）必须完全兼容，否则将触发声明不兼容错误——掌握这些核心规范，是避免“编译通过、运行报错”陷阱、构建可维护PHP架构的关键基础。

interface 声明后不能直接 new

PHP 的 interface 是契约，不是类，不能实例化。写 new MyInterface() 会报 Fatal error: Cannot instantiate interface。这点和抽象类不同，哪怕 interface 里全是空方法，也不行。

必须用具体类 implements 它，再实例化那个类：

interface Logger {
    public function log(string $msg): void;
}

class FileLogger implements Logger {
    public function log(string $msg): void {
        file_put_contents('app.log', $msg . PHP_EOL, FILE_APPEND);
    }
}

$logger = new FileLogger(); // ✅ 正确
// $logger = new Logger();   // ❌ 致命错误

• 常见错误：把 interface 当成基类，在工厂或 DI 容器配置里直接 new interface 名字
• 正确做法：容器绑定时，把 interface 映射到具体实现类，如 $container->bind(Logger::class, FileLogger::class)
• 如果只声明 interface 没写任何 implements 类，代码能通过语法检查，但运行时根本没法用——这是典型的“编译通过，上线报错”陷阱

interface 方法不能有访问修饰符以外的修饰符

PHP interface 中的方法只能是 public，且不能加 final、static、abstract（它本身就是抽象的）、protected 或 private。写错会触发 Parse error: syntax error。

比如下面这些全都不合法：

interface Service {
    final public function run();     // ❌ final 不允许
    static public function init();   // ❌ static 不允许
    protected function check();      // ❌ protected 不允许
    private function cleanup();      // ❌ private 不允许
}

• PHP 8.0+ 允许 interface 中定义常量和静态方法，但静态方法必须带 static 关键字且有函数体（即不是纯声明），和传统 interface 方法性质不同
• 接口方法默认就是 public，所以显式写 public 是推荐的（提高可读性），不写也不会报错，但团队规范建议统一加上
• 别试图在 interface 里塞逻辑——哪怕是一行 return true;，那已经不是 interface，该用 trait 或抽象类了

多个 interface 同名方法的参数必须完全兼容

一个类同时 implements A, B，而 A 和 B 都有 handle() 方法，那么这两个 handle() 的签名（参数类型、数量、顺序、返回类型）必须能被同一个实现覆盖。否则会报 Declaration of X::handle() must be compatible with Y::handle()。

例如：

interface Reader {
    public function read(string $path): array;
}

interface Writer {
    public function read(string $path, bool $raw = false): array; // 多了一个参数
}

class FileReader implements Reader, Writer { ... } // ❌ 报错：参数不兼容

• 解决办法只有两个：要么统一两个 interface 的方法签名（推荐）；要么让其中一个 interface 改名，比如 readRaw()
• PHP 不支持接口方法重载，也没有“协变参数”这种机制（不像 Java 的 extends T>），所以参数列表差异哪怕只是加个默认值，也算不兼容
• 这问题常出现在引入第三方 SDK 时——你自己的 CacheInterface 和 SDK 的 Cacheable 碰巧都叫 get()，但参数对不上，结果一 implement 就崩

interface 不强制要求实现所有方法？不，它强制

只要类声明 implements X，就必须实现 X 中定义的每一个方法，一个都不能少，也不能只实现一部分。漏掉会报 Class Y contains 1 abstract method and must therefore be declared abstract or implement the remaining methods。

注意：这个“必须实现”是硬性语法约束，不是运行时检查。

• 容易踩的坑：升级 PHP 版本后，某个 interface 新增了方法（比如 PHP 8.2 给 Stringable 加了新能力），你的老实现类没更新，就会突然报错
• IDE（如 PHPStorm）有时不会实时标红缺失方法，尤其在 interface 被 require_once 动态加载时，得靠 php -l 或 CI 流水线暴露问题
• 如果真想“跳过”某些方法，说明设计有问题——interface 职责太重了，该拆分成更小的、正交的 interface（比如 Readable、Writable、Flushable）

interface 的边界感特别强：它不管你怎么实现，只管你有没有承诺。承诺了，就得兑现；没承诺，就别写 implements。很多人卡住，不是因为不会写，而是没想清楚这个“承诺”到底要覆盖哪些场景。

今天关于《PHP接口开发与使用规范详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！