__tostring 方法在对象用于字符串上下文时自动调用，如 echo $obj、(string)$obj、拼接 "str".$obj 等；必须返回 string 类型，否则抛出致命错误。
__toString 方法什么时候会被自动调用
当对象出现在需要字符串的上下文中，PHP 就会自动触发 __toString，不需要你手动写 $obj->__toString()。比如：echo $obj、print $obj、(string)$obj、字符串拼接 "result: " . $obj、日志写入 error_log($obj) 等场景。
它不是“可选功能”，而是 PHP 强制要求：如果类定义了 __toString，该方法**必须返回 string 类型值**，否则会抛出 Fatal error: Method xxx::__toString() must return a string value。
自定义 __toString 的典型写法和常见错误
最简合规实现长这样：
public function __toString(): string
{
return sprintf('User(id=%d, name="%s")', $this->id ?? 0, $this->name ?? '');
}
容易踩的坑包括：
- 忘记声明返回类型
: string（PHP 7.1+ 强烈建议加，否则类型不匹配时错误不明显） - 在方法里调用了可能抛异常的逻辑（比如访问未初始化的属性、远程 API），而
__toString不能 throw 异常 —— 一旦抛出，直接 fatal error - 返回了
null、array或对象，哪怕只有一处return $this->data;而$this->data是数组，也会崩溃 - 试图在
__toString里做 heavy work（如查数据库、序列化大对象），这会让日志、调试、模板渲染等所有字符串化场景变慢甚至卡死
Exception::__toString 是个特例
PHP 内置的 Exception 类已经实现了 __toString，默认返回类似这样的字符串：
exception 'InvalidArgumentException' with message 'Invalid ID' in /app/User.php:42
Stack trace:
#0 /app/Controller.php(12): User->__construct(0)
#1 {main}
这个输出是稳定的、安全的，且包含 getMessage()、getFile()、getLine() 和 getTraceAsString()。你继承 Exception 时，除非想隐藏堆栈或精简信息，否则不用重写它。
但要注意：如果你在自定义异常里重写了 __toString，又忘了调用 parent::__toString()，就丢失了 trace 信息，排查问题会非常困难。
别把它当成调试 dump 工具
__toString 的定位是“提供简洁、稳定、可预期的字符串表示”，不是 var_dump 替代品。很多人一上来就写：
return print_r($this, true);
这看似省事，但会导致：
- 输出含大量内部结构（如 private 属性的
\0Class\0prop格式），可读性差 - 若对象有循环引用（比如 A→B→A），
print_r会无限展开或截断，__toString却无法捕获这个错误，直接 fatal - 性能开销不可控，尤其在高并发日志场景下，可能拖垮整个服务
真要调试，用 __debugInfo 配合 IDE 或 xdebug；要记录结构化日志，用 json_encode($this->toArray()) 这类显式方法更可控。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
