self 是 php 8.0+ 引入的返回类型声明关键字，表示“当前类的实例”，用于替代硬编码类名，提升代码可维护性与继承兼容性。
`self` 是 php 8.0+ 引入的返回类型声明关键字，表示“当前类的实例”，用于替代硬编码类名，提升代码可维护性与继承兼容性。
在现代 PHP（尤其是 Laravel 等框架的查询构建器模式中），方法链式调用（method chaining）是核心设计范式——每个方法返回 $this，从而支持如 $query->wherePaid()->whereAmountGreaterThan(100)->get() 这样的流畅语法。而 : self 正是为这类模式提供精确、安全、可继承的类型提示的关键机制。
什么是 self？它和 Static、$this 有何区别？
- self：静态解析的当前类名，编译时即确定，始终指向定义该方法的类（而非调用者类）。它等价于硬编码的类名，但更简洁、更安全。
- static：支持后期静态绑定（Late Static Binding），指向实际调用该方法的类（在继承场景下可能为子类）。
- $this：运行时对象实例，不能直接用作返回类型（PHP 类型系统要求返回类型是明确的标识符，如 String、int 或类名）。
✅ 正确（推荐用于链式构建器基类）：
class InvoiceQueryBuilder extends Builder { public function wherePaid(): self { return $this->whereState('status', Paid::class); } }等价于：
public function wherePaid(): InvoiceQueryBuilder { return $this->whereState('status', Paid::class); }⚠️ 注意：若你希望子类继承后仍能保持返回子类类型（例如 ExtendedInvoiceQueryBuilder 调用 wherePaid() 时返回自身类型），则应使用 : static —— 但需确保所有链式方法均一致使用 static，否则类型推导会断裂。
立即学习“PHP免费学习笔记（深入）”；
实际好处：类型安全 + ide 支持 + 继承友好
假设你扩展了查询构建器：
class RefundInvoiceQueryBuilder extends InvoiceQueryBuilder { public function whereRefunded(): self { return $this->whereState('status', Refunded::class); } }此时：
- RefundInvoiceQueryBuilder::wherePaid() 的返回类型仍是 RefundInvoiceQueryBuilder（因为 self 在父类中解析为 InvoiceQueryBuilder，但该方法被继承后，在子类上下文中 self 仍指代子类自身 ✅ —— 这是 PHP 的语义：self 在被调用的位置所属的类中解析，而非定义位置。
? 补充说明：严格来说，self 总是指当前作用域所在类（即方法定义所在的类），但此处 wherePaid() 是在 InvoiceQueryBuilder 中定义的，当它被 RefundInvoiceQueryBuilder 继承并调用时，其返回类型 self 仍解析为 InvoiceQueryBuilder —— 这正是问题所在！因此，若需真正的协变返回（子类调用返回子类类型），必须用 : static。
✅ 正确做法（推荐 laravel 风格）：public function wherePaid(): static { return $this->whereState('status', Paid::class); }
最佳实践总结
- ✅ 优先使用 : static：适用于所有需要支持继承与方法链式调用的构建器类（Laravel 9+ 源码已全面采用 static）；
- ✅ : self 适用场景：类为 final，或明确不希望子类覆盖行为，且需强约束返回“本类”（非子类）实例；
- ❌ 避免 : $this：语法错误，PHP 不允许将变量用作返回类型；
- ? 启用严格类型检查：确保 declare(strict_types=1); 已启用，使 : static 类型提示在运行时生效（部分检查在静态分析阶段，如 PHPStan/IDE）；
- ? 小技巧：配合 PHP 8.1+ 的 never 或 void 可进一步明确终止型方法（如 ->dd()、->dump()），增强 API 可读性。
掌握 self 与 static 的差异，不仅是语法细节，更是写出可扩展、易维护、IDE 友好型 PHP 库的关键一步。