self 是 PHP 7.4+ 引入的返回类型声明关键字，表示方法返回当前类的实例（而非父类或具体子类），专为构建类型安全、可继承的 Fluent API 而设计。
`self` 是 php 7.4+ 引入的返回类型声明关键字，表示方法返回当前类的实例（而非父类或具体子类），专为构建类型安全、可继承的 fluent api 而设计。
在现代 PHP 开发中，尤其是 Laravel 等框架的查询构造器（Query Builder）模式中，方法链式调用（如 $query->wherePaid()->whereYear('created_at', 2024)->get()）已成为标准实践。要实现既流畅又类型安全的链式调用，返回类型的精准声明至关重要——而 self 正是为此场景量身定制的关键字。
self 的本质：静态绑定的当前类名
self 并非动态类型，也不是 static（后者支持后期静态绑定），而是一个编译期解析的类名别名，等价于当前类的完整限定名称（FQCN）。例如：
class InvoiceQueryBuilder extends Builder
{
public function wherePaid(): self
{
return $this->whereState('status', Paid::class);
}
}等价于：
public function wherePaid(): InvoiceQueryBuilder
{
return $this->whereState('status', Paid::class);
}✅ 优势在于：代码更简洁、可维护性更高；当类名变更时，仅需修改一处（class 声明），无需逐个更新返回类型。
立即学习“PHP免费学习笔记（深入）”；
与 static 和 $this 的关键区别
| 类型 | 绑定时机 | 是否支持继承后正确返回子类实例 | 典型用途 |
|---|---|---|---|
| self | 编译时（早期绑定） | ❌ 返回声明该方法的类（如 InvoiceQueryBuilder），即使被子类调用 | 适用于不期望被继承重写的稳定接口 |
| static | 运行时（后期静态绑定） | ✅ 返回实际调用者类（如 ExtendedInvoiceBuilder） | 适合需在继承链中保持类型精确的 Fluent 构造器 |
| $this | 运行时（对象实例） | ✅（但无类型提示，IDE 和静态分析无法识别） | PHP 8.0 前的妥协方案，现已不推荐 |
⚠️ 注意：若你预期该方法可能被子类继承并用于链式调用（例如 ExtendedInvoiceBuilder extends InvoiceQueryBuilder），应优先使用 static 而非 self，否则子类调用 wherePaid() 将返回 InvoiceQueryBuilder 类型，破坏类型一致性。
实际应用示例：构建可继承的查询构造器
class Builder
{
public function where(string $column, $value): static
{
// ... 通用逻辑
return $this;
}
}
class InvoiceQueryBuilder extends Builder
{
// 使用 static → 子类调用时仍返回子类实例
public function wherePaid(): static
{
return $this->where('status', 'paid');
}
}
// ✅ 完全类型安全的链式调用
$builder = new InvoiceQueryBuilder();
$result = $builder->wherePaid()->where('amount', '>', 100); // IDE 可推导出 $result 是 InvoiceQueryBuilder
// 若此处用 self，则 ExtendedInvoiceBuilder->wherePaid() 将错误提示返回 InvoiceQueryBuilder
class ExtendedInvoiceBuilder extends InvoiceQueryBuilder
{
public function withTax(): static
{
return $this;
}
}总结建议
- ✅ 优先使用 static：对于所有意图支持继承与链式调用的 Fluent 方法（如 Laravel 的 Builder 体系），static 是更健壮、更符合直觉的选择；
- ✅ 谨慎使用 self：仅在明确禁止继承、或需强制固定返回类型（如内部工具类）时采用；
- ❌ 避免裸写 $this：PHP 8.0+ 应始终用 static 或 self 替代无类型声明的 return $this;，以保障 IDE 支持、静态分析（如 PHPStan）和团队协作质量；
- ? 开发环境要求：确保项目运行于 PHP ≥ 7.4，并启用严格类型模式（declare(strict_types=1);）以获得最佳类型保障。
掌握 self 与 static 的语义差异，是写出可扩展、易维护、类型安全的 PHP 领域模型与构造器的关键一步。
