__tostring仅在隐式转字符串时触发（如echo、拼接、strval()、(string)$obj），不用于json_encode()或var_dump()；必须返回string，否则致命错误；不可抛异常，需主动处理异常情况并返回字符串。
PHP中__toString不是万能的字符串转换入口，它只在明确需要字符串上下文时才被调用，且不能返回非字符串值——否则会直接报致命错误。
哪些场景下__toString会被自动触发
这个方法只在对象被「隐式转换为字符串」时执行，比如拼接、echo、print、strval()，但不会在json_encode()、var_dump()、类型强制转换(string)$obj（注意：这个其实会触发）中无条件生效——等等，(string)$obj确实会触发，但json_encode()和var_dump()完全无视它。
-
echo $obj→ 触发 -
return $obj . 'suffix'→ 触发 -
printf('%s', $obj)→ 触发 -
(string)$obj→ 触发（这是显式转换，但PHP仍走__toString） -
json_encode([$obj])→ 不触发，输出{}" or <code>null（取决于是否实现JsonSerializable） -
var_dump($obj)→ 不触发，显示对象结构
__toString必须返回string，否则直接Fatal error
哪怕返回int、null、空数组或未定义变量，PHP都会中断执行并抛出Fatal error: Method xxx::__toString() must return a string。它不接受任何妥协，也不会尝试隐式转换返回值。
- 错误写法：
return 123;、return $this->name ?? '';（当$this->name是对象且没实现__toString时，这里会二次触发转换失败） - 安全写法：
return (string)($this->name ?? '');或return is_scalar($this->name) ? (string)$this->name : ''; - 调试建议：在开发阶段加
assert(is_string($result), 'Invalid __toString return');辅助定位问题
不能抛异常，也不能有void逻辑
PHP要求__toString必须有返回值，且仅限string。如果内部逻辑可能失败（如依赖外部资源、格式化出错），不能靠throw绕过约束——异常抛出会变成Fatal error，因为PHP不允许魔术方法在字符串上下文中“失败”。
- 禁止：
throw new RuntimeException('ID missing'); - 可行：
return '[Invalid User]';或return sprintf('[User#%s]', $this->id ?: '?'); - 注意：
error_log()可用来记录问题，但不能影响返回值类型
真正容易被忽略的是：一旦类中定义了__toString，它就成为该对象对外最“可见”的文本表达，但这个表达既不参与序列化，也不影响比较（==或===仍看属性），更不会被IDE自动提示用于日志打印——你得主动用echo或拼接才能让它生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
