__toString 必须返回字符串，否则触发致命错误；仅在字符串上下文（如echo、拼接）中调用，不用于比较或数组键；禁止重操作、异常、非字符串返回及编码转换，应仅基于已有属性快速生成字符串。
__toString 必须返回字符串，否则会报致命错误
PHP 的 __toString 是少数几个不允许抛出异常、也不允许返回非字符串的魔术方法。一旦返回 null、数组、对象或没写 return，就会直接触发 Fatal error: Method xxx::__toString() must return a string。
常见踩坑点：
- 调试时临时加了
var_dump($this->data);但忘了删，导致隐式输出 + 无返回值 - 条件分支里漏写了某个
return，比如if ($debug) { return json_encode(...); }却没配else - 调用了可能返回
false的函数（如json_encode失败），没做兜底：return json_encode($arr) ?: '';
__toString 在字符串上下文中才被触发，echo/print 不等于强制转换
它只在「需要字符串值」的场景下自动调用，比如拼接、echo、print、strval()，但不会在 == 比较、isset()、empty() 或数组键访问中触发。
典型误用场景：
立即学习“PHP免费学习笔记（深入）”；
-
if ($obj == 'expected') { ... }—— 这里__toString完全不执行，PHP 做的是对象身份比较 -
$arr[$obj] = 1;—— 会报Illegal offset type，因为数组键不走__toString - 想用它实现“对象转 JSON”，结果在
json_encode($obj)里完全没效果 ——json_encode不调用__toString
不要在 __toString 里做重操作或依赖外部状态
这个方法常被用在日志、调试、模板渲染等链路里，调用时机不可控，且可能高频发生（比如循环里 echo $item）。一旦里面包含数据库查询、文件读取、远程 API 调用，性能会迅速崩坏。
安全做法：
- 只基于当前对象已有的属性生成字符串，避免懒加载或计算逻辑
- 如果必须格式化复杂数据，提前在构造或 setter 中缓存好字符串结果，
__toString直接返回缓存值 - 避免调用其他可能触发 autoload 或触发更多魔术方法的代码（比如访问未声明属性触发
__get）
示例（推荐）：
private $toStringCache;
public function __toString() { return $this->toStringCache ?: ($this->toStringCache = $this->formatForLog()); }
__toString 无法处理编码问题，中文乱码要靠内容本身保证
PHP 不会帮你转编码，__toString 返回什么字节流，就原样输出。如果对象内部存的是 GBK 字符串，而页面是 UTF-8，浏览器就会显示乱码 —— 这和 __toString 无关，是数据源头和上下文编码不一致。
排查要点：
- 确认对象属性里的字符串已经是目标编码（通常是 UTF-8）
- 检查输出环境：CLI 下默认无编码约束，Web 下看
Content-Type响应头是否带; charset=utf-8 - 不要在
__toString里硬加iconv或mb_convert_encoding—— 这会让方法职责变重，且容易因输入编码未知而失败
真正该做的是统一数据入口编码，而不是在 toString 里补救。
很多同学卡在“明明写了 return 却还报错”，其实只是某条分支悄悄返回了void；还有人指望它能替代 jsonSerialize 或解决模板引擎里的对象渲染问题——这些都不是它的设计边界。 
