Stringable接口不改变运行时行为，但需显式声明才能通过静态分析；兼容PHP 7.4需条件定义或改用string|object提示；string|Stringable精确约束可字符串化类型，不自动调用__toString()。
PHP 8.0 引入的 Stringable 接口本身不改变运行时行为，但它的“自动满足”机制与类型提示结合后，在版本兼容性和静态分析层面会带来明显影响——尤其当代码需兼顾 PHP 7.4 或更低版本时。
Stringable 的自动满足仅限运行时，静态分析不认账
PHP 运行时确实会把任何实现了 __toString() 的类当作 Stringable，比如：
- 传给
function log(string|Stringable $msg) { ... }的对象，即使没写implements Stringable，也能通过运行时检查； - 但 PHPStan、Psalm 或 PhpStorm 在分析时看不到这个“隐式实现”，会报错：
Parameter #1 $msg expects Stringable, object given； - 这意味着：不显式声明
implements Stringable，类型提示在开发阶段就失效了，IDE 补全、参数跳转、重构支持都会打折扣。
向下兼容 PHP 7.4 的安全写法
直接使用 Stringable 会导致 PHP 7.x 环境下致命错误：Fatal error: Interface 'Stringable' not found。要兼容老版本，推荐两种策略：
- 用条件接口声明：在类定义前加
if (!interface_exists('Stringable')) { interface Stringable {} }（仅用于类型提示，不参与运行逻辑）； - 更稳妥的做法是保留
string|object类型提示，同时在文档或注释中强调“对象须实现__toString()”； - 若必须用
string|Stringable，建议通过 Composer 的platform配置或 CI 环境变量明确限定最低 PHP 版本为 8.0+，避免误部署。
联合类型 string|Stringable 的真实约束力
这个类型组合不是“宽松放行”，而是精确表达语义：
立即学习“PHP免费学习笔记（深入）”；
- 接受原生字符串，也接受能转成字符串的对象——但绝不接受数组、
null、整数等非字符串化类型； - 它不会自动调用
__toString()，只是保证调用时不会因类型不符而失败； - 如果对象的
__toString()返回null或抛异常，错误仍会发生，只是发生在转换那一刻，而非参数传入时。
升级老项目时最容易忽略的三点
很多团队在迁移到 PHP 8.0 后才发现问题，根源常在这几个细节：
- 已有类写了
__toString()，但没补implements Stringable，导致新写的string|Stringable参数函数无法接收这些旧类实例； - 测试用例里用了
mock对象，但 mock 没实现__toString()，结果在日志或模板渲染环节突然崩溃； - 第三方库未更新，其类型提示仍用
mixed或object，和你的string|Stringable函数对接时，静态分析工具无法推导出兼容性。
