self 是 php 7.4+ 引入的返回类型声明关键字，表示方法返回当前类的实例（而非父类或字符串字面量），既提升类型安全性，又天然支持方法链式调用。
`self` 是 php 7.4+ 引入的返回类型声明关键字，表示方法返回当前类的实例（而非父类或字符串字面量），既提升类型安全性，又天然支持方法链式调用。
在现代 PHP 开发（尤其是 laravel 等框架的构建器模式中），self 作为返回类型被广泛用于实现类型安全的链式调用（fluent Interface）。它并非一个动态值或特殊对象，而是一个静态类型提示——编译器和 ide 可据此推断返回值的确切类型，从而提供准确的代码补全、类型检查和重构支持。
为什么用 self 而不是具体类名？
以你引用的 InvoiceQueryBuilder 示例为例：
class InvoiceQueryBuilder extends Builder { public function wherePaid(): self { return $this->whereState('status', Paid::class); } }此处的 : self 等价于 : InvoiceQueryBuilder，但优势在于可维护性与继承友好性：
- ✅ 若类名后续重命名为 PaidInvoiceQueryBuilder，无需修改所有 : InvoiceQueryBuilder 返回声明；
- ✅ 在继承场景下仍保持语义正确（子类方法若未重写，self 自动指向子类自身，而非父类）；
- ❌ 而硬编码类名（如 : InvoiceQueryBuilder）在子类中重写该方法时，若返回 parent::wherePaid()，类型将不匹配，破坏链式调用。
对比更清晰的继承示例：
立即学习“PHP免费学习笔记（深入）”；
class AdvancedInvoiceQueryBuilder extends InvoiceQueryBuilder { public function whereHighValue(): self { return $this->where('amount', '>', 10000); } } // 可安全链式调用，且 IDE 精准识别返回类型为 AdvancedInvoiceQueryBuilder $query = (new AdvancedInvoiceQueryBuilder()) ->wherePaid() ->whereHighValue() ->get();⚠️ 注意：self 指向定义该方法的类（即“词法作用域”），而非运行时 $this 的实际类型。若需真正动态绑定到运行时类型，请使用 Static（后期静态绑定）。例如：
public function cloneWithStatus(): static { ... } // 返回实际调用者类型（支持协变）
实际开发建议
- ✅ 优先使用 self：适用于明确只在当前类内复用、不预期被子类覆盖行为的构建器方法；
- ✅ 配合 PHP 8.1+ never 或 void：对不返回实例的终结方法（如 ->get()、->first()）标注 : Collection|Model|NULL 或 : never（若抛异常退出），增强类型完整性；
- ? 避免混用 self 和 Builder 等父类类型：会丢失子类特有方法的类型提示，削弱链式调用体验。
总之，self 不是魔法，而是 PHP 类型系统为面向对象链式 API 提供的简洁、可靠、可演进的工具——它让代码既自文档化，又经得起重构考验。