PHP方法链式调用的核心是每个流转方法必须显式返回$this，终结方法（如get()、toArray()）则返回结果值；需严格区分两类方法，避免链中断。
PHP 方法链式调用的核心是 return $this
链式调用不是语法特性，而是靠方法显式返回 $this 实现的。只要一个方法末尾写 return $this;，调用后就能继续点下个方法。不返回 $this（比如返回 void、bool 或新对象），链就断了。
常见错误现象：Call to a member function xxx() on null 或 Call to a member function xxx() on bool——说明上一个方法没返回对象实例，而是返回了别的类型。
- 所有想参与链式调用的方法，必须以
return $this;结尾（不能只写$this;） - 如果某个方法需要返回原始值（如
get()、count()），它就不该出现在链中间，而应放在末尾 - 构造函数和静态工厂方法无法直接链式调用，需先实例化或用
new static()等方式确保返回对象
避免在链中混入非对象返回值方法
比如你写了 $obj->setA('x')->setB('y')->toArray()，但 toArray() 返回的是 array，后面再点方法就会报错。这类“终结方法”要和“流转方法”区分开。
使用场景：构建器（Builder）、查询构造器（Query Builder）、表单验证器等，通常把设置类方法设计为流转型，把获取/执行类方法设计为终结型。
立即学习“PHP免费学习笔记（深入）”；
- 推荐命名约定：
setXxx()、withXxx()、where()、orderBy()→ 流转型，返回$this -
get()、first()、all()、jsonSerialize()→ 终结型，返回数据或结果，不返回$this - 不要强行让
save()返回$this：如果它实际执行了数据库写入并可能失败，返回bool或抛异常更合理
注意 PHP 7.4+ 属性类型与链式调用的兼容性
当你给属性加了类型声明（如 private string $name;），并在构造函数里初始化，这本身不影响链式调用；但若在流转方法里做了类型敏感操作（比如 $this->name .= $suffix;），而 $suffix 是 null 或数字，可能触发严格类型错误，导致链提前中断。
性能影响很小，但可读性和维护成本会上升：每个流转方法都要确认是否修改了状态、是否可能抛异常、是否仍满足对象一致性。
- 流转方法应尽量保持幂等和无副作用（除修改自身状态外）
- 如果方法内部调用了外部服务或数据库，建议不纳入链式路径，改用显式分步调用
- IDE 和静态分析工具（如 PHPStan）可能无法推导链式调用后的类型，必要时可用 PHPDoc 注释
@return static声明返回类型
链式调用 + 可选参数时怎么设计方法签名
别为了链式强行塞一堆参数进单个方法。比如 filter($key, $value, $operator, $strict, $caseSensitive) 不如拆成 where($key, $value)、whereLike($key, $value)、whereIn($key, $values) 等语义明确的方法，每个都返回 $this。
实在需要灵活参数，可用数组或对象封装选项，再配合 fluent 接口：
public function where(array $conditions): static
{
$this->wheres[] = $conditions;
return $this;
}
- 避免使用可变参数
...$args做复杂逻辑分发，易读性差且 IDE 支持弱 - 若方法支持“重置”行为（如
clearFilters()），它也应返回$this，保持链的连续性 - 不要在流转方法里做条件跳过：比如
if ($this->locked) return $this;是 OK 的；但if ($this->locked) return null;就会断链
