PHP方法链的本质是返回 $this
方法链不是语法糖，而是靠每个方法显式返回 $this 实现的。只要一个方法返回了别的东西（比如 return true、return $result 或没写 return），链就断了。
常见错误现象：Call to a member function xxx() on bool 或 on null，基本就是某个中间方法没返回 $this。
- 必须在每个想参与链式调用的方法末尾加
return $this; - 构造函数不用返回
$this，但建议用__construct()初始化状态，避免链首调用失败 - 如果某个方法逻辑上不该继续链（比如
save()或toArray()），就别返回$this—— 这是设计意图，不是 bug
链式调用中如何处理参数校验和提前退出
一旦开始链式调用，就不能靠 return false 或抛异常来“中断流程”而不破坏调用结构，否则后续方法会报错。
典型场景：表单验证类的 required() → email() → maxLength(50)，其中某步不通过，还想让链继续跑完收集所有错误？
立即学习“PHP免费学习笔记（深入）”；
- 不要在验证方法里
return false；统一用内部属性（如$this->errors = []）累积错误 - 每个方法仍返回
$this，保证链不断，把“是否有效”的判断延迟到最终isValid()或run() - 如果真要中途终止链（比如权限不足直接跳过后续），可用
throw new RuntimeException('xxx')，但得确保调用方能捕获——这不是链式设计的本意，慎用
return $this 和 return static 的区别影响链式继承
当子类继承链式类并调用父类方法时，如果父类方法写的是 return $this，子类链调用没问题；但如果写成 return new self 或漏掉 return，子类实例就会被“降级”成父类实例。
更隐蔽的问题：某些 IDE 或静态分析工具（如 PHPStan）会把 $this 当作当前类，但若方法返回 self，类型推导可能出错。
- 始终用
return $this;，而不是return new static或return new self - 如果类支持 Fluent 接口且需子类安全，方法签名可加 PHPDoc：
@return static，但运行时仍靠$this - 注意 PHP 8.1+ 的
final方法不能被子类覆盖，若父类链方法是final，子类无法定制行为，容易踩坑
什么时候不该用方法链
不是所有类都适合链式。强行套用会让代码难调试、类型不可控、IDE 补全失效。
典型反例：数据库查询构建器（OK）、HTTP 客户端（OK），但用户实体类的 $user->setName()->setAge()->setEmail() 就多余——这些 setter 本来就不该有业务逻辑，也不需要顺序约束。
- 当方法之间无依赖、无状态累积（比如纯 setter），链式只是炫技，增加阅读成本
- 当方法可能返回不同类型的值（如
first()返回模型，get()返回集合），强行链会导致类型混乱 - 单元测试时，链式调用会让 mock 更复杂；一个方法调用失败，整条链断点难定位
链式真正的价值在于表达「一组协同操作的不可分割动作」，比如配置 + 执行、条件 + 查询、验证 + 提交。没这个语义，就别硬链。
