__toString 方法仅在对象被当作字符串使用时自动调用，如 echo $obj、"{$obj}" 等场景；(string)$obj 会触发，但 json_encode()、var_dump() 等无视它；必须返回字符串，不可返回 null 或数字，且不应含 I/O 或耗时操作。
__toString 方法什么时候会被自动调用
它只在对象被当作字符串使用时触发，比如 echo $obj、print $obj、"result: {$obj}" 这类上下文。不是所有字符串转换场景都会走它——类型强制转换如 (string)$obj 会调用，但 json_encode($obj) 或 var_dump($obj) 完全无视它。
常见错误现象：Fatal error: Method MyClass::__toString() must return a string，说明返回值不是字符串类型，哪怕返回 null 或 0 都会报错。
- 必须有
return语句，且返回值类型为string - 不能抛出异常（PHP 7.4+ 允许，但早期版本会直接 fatal）
- 不能用于数组拼接：
['a', $obj]不会触发，只有字符串插值或输出才触发
为什么不能在 __toString 里做耗时操作
它常被用在日志、调试、模板渲染等链路中，而这些地方对响应时间敏感。一旦你在里面查数据库、调 API、递归遍历大数组，就会让 echo $user 这种看似无害的操作变成性能瓶颈。
使用场景举例：Laravel 的 Eloquent 模型默认没实现 __toString，但你若给 User 类加一个返回 $this->name 的实现，就可能在 Blade 模板里无意触发——尤其当模板循环渲染上百个对象时。
立即学习“PHP免费学习笔记（深入）”；
- 避免 I/O 操作：不查库、不发 HTTP 请求
- 避免复杂逻辑：不格式化日期、不拼接 HTML 片段（除非明确设计为“可渲染对象”）
- 建议只返回已存在的字段组合，比如
return $this->title . ' (#' . $this->id . ')';
__toString 和 JSON 序列化的区别在哪
很多人以为加了 __toString 就能让 json_encode() 输出自定义内容，其实完全无关。json_encode() 看的是 JsonSerializable 接口或 __toArray()（非标准）、或直接序列化 public 属性。
错误现象：json_encode($obj) 仍输出空对象 {}，即使 __toString 返回了漂亮字符串。
-
__toString只影响字符串上下文，不影响 JSON、XML、序列化（serialize()） - 想控制 JSON 输出，必须实现
JsonSerializable接口，重写jsonSerialize() - 两者可以共存，但职责分离：一个管“怎么被 echo”，一个管“怎么被转成 JSON”
继承和 trait 中的 __toString 冲突怎么处理
PHP 不允许子类重写父类的 __toString 为不同签名（比如改返回类型），但更常见的是：多个 trait 都定义了 __toString，导致 Cannot declare method __toString because the class already has such a method。
这不是语法限制，而是 PHP 在 trait 合并阶段就拒绝重复方法名——哪怕它们逻辑一致也不行。
- 只能保留一个
__toString实现，其他 trait 改用普通方法，比如toStringFormat() - 如果必须复用逻辑，把核心字符串生成抽成私有方法，在各处
__toString中调用它 - 注意：抽象类里定义
abstract public function __toString(): string;是合法的，子类必须实现
最易被忽略的一点：__toString 的返回值会被隐式缓存进字符串上下文，但不会被 PHP 缓存；每次触发都重新执行方法体。所以哪怕它只读属性，也要小心属性本身是否在运行时被修改过。
