php 8.1 引入对内置类方法重载时返回类型不兼容的弃用警告，本质是补全语言类型系统的一致性缺口——它并非新增限制，而是将长期存在的 lsp（里氏替换原则）要求显式化、强制化，使用户代码与内置类共同遵守同一套面向对象契约。
在面向对象设计中，子类必须能安全替代父类出现在任何上下文中——这是里氏替换原则（Liskov Substitution Principle, LSP）的核心。若子类方法的返回类型与父类不兼容（例如父类返回 mysqli_result|bool，子类却声明返回 ?MySqlResult），调用方代码将失去类型安全保证：原本可对 mysqli_result 调用 fetch_assoc() 的逻辑，在传入子类实例后可能因实际返回 MySqlResult 或 null 而崩溃，或因类型不匹配触发静默错误。
值得注意的是，PHP 从未允许真正“不兼容”的返回类型重载。以下代码在 PHP 7.4+ 中已直接报致命错误（Fatal Error），而非等到 8.1：
class A {
public function getValue(): string { return "hello"; }
}
class B extends A {
public function getValue(): int { return 42; } // ❌ Fatal error: Declaration must be compatible
}问题根源在于：PHP 内置类（如 mysqli）长期缺失显式返回类型声明。由于历史原因（资源类型、mixed 表达能力不足、向后兼容等），其方法在引擎层面未标注返回类型，导致 PHP 类型系统“视而不见”——子类反而被允许随意声明返回类型，形成事实上的契约断裂。
PHP 8.1 通过 RFC: Internal Method Return Types 为绝大多数内置方法补全了准确的返回类型（如 mysqli::query() 明确标注为 mysqli_result|bool）。为避免大规模破坏性变更，PHP 选择先以 Deprecated 警告过渡，而非立即抛出 Fatal error；预计 PHP 9.0 将彻底执行该约束。
立即学习“PHP免费学习笔记（深入）”；
正确实践：用组合替代继承
针对您的 MySql 类场景，继承 mysqli 并重写 query() 不仅违反 LSP，还带来紧耦合、难以测试、无法复用等问题。推荐采用组合模式：
class MySql {
private \mysqli $connection;
public function __construct(string $host, string $user, string $pass, string $db) {
$this->connection = new \mysqli($host, $user, $pass, $db);
}
public function query(string $sql): MySqlResult {
$result = $this->connection->query($sql);
return new MySqlResult($result);
}
// 如需访问原生连接，提供受控委托
public function getNativeConnection(): \mysqli {
return $this->connection;
}
}✅ 优势：
- 类型安全：query() 的返回类型完全由您控制，无兼容性冲突；
- 遵循单一职责：MySql 专注封装业务逻辑，不承担 mysqli 的底层协议细节；
- 易于 Mock：单元测试时可轻松注入模拟连接；
- 可扩展：可同时组合 PDO 或其他驱动，实现多后端支持。
总结
PHP 8.1 的这一变更不是“增加限制”，而是修复语言类型系统的逻辑断层：它统一了用户类与内置类的继承契约，强制所有重载方法满足协变（covariant）返回类型规则（即子类可返回更具体的子类型，但不可返回无关或更宽泛的类型）。这与 Java、C#、TypeScript 等成熟静态类型语言的设计完全一致。拥抱这一变化，意味着写出更健壮、可维护、符合 OOP 基本原则的代码——而组合，永远比脆弱的继承更接近设计的本质。
