trigger_error() 是 PHP 中唯一推荐的错误触发方式，专为被 set_error_handler() 统一捕获而设计，生成 E_USER_ERROR/E_USER_WARNING/E_USER_NOTICE 等传统错误，支持日志、监控与统一处理。
trigger_error() 是唯一推荐的触发方式
PHP 里没有 throw 以外的“错误抛出”机制能被错误处理器统一捕获，trigger_error() 就是专为此设计的标准函数。它生成的不是异常，而是传统 PHP 错误（E_USER_WARNING、E_USER_NOTICE 等），能被 set_error_handler() 拦截，也能在未设置处理器时按默认规则输出或记录。
常见错误现象：有人用 die() 或 echo "error" + exit 模拟报错，结果日志里找不到记录、监控收不到信号、调用方无法区分业务失败和崩溃；也有人误用 throw new Exception()，但下游只监听错误而非异常，导致逻辑断裂。
-
trigger_error()第二个参数必须是E_USER_ERROR/E_USER_WARNING/E_USER_NOTICE三者之一，其他值（如E_WARNING）会被静默忽略 - 错误消息长度建议控制在 1024 字符内，超长可能被截断，且部分 SAPI（如 CLI）对输出宽度有限制
- 在 Composer 自动加载器或早期 bootstrap 阶段调用前，确认
set_error_handler()已注册，否则错误直接显示或写入 error_log，不走自定义逻辑
如何让 trigger_error() 被 set_error_handler() 正确捕获
关键不在 trigger_error() 本身，而在错误处理器是否启用、作用域是否覆盖、返回值是否合规。很多问题其实出在 handler 写法上。
使用场景：你写了 set_error_handler('my_handler')，但 trigger_error("xxx") 还是直接打印到页面，没进你的函数。
立即学习“PHP免费学习笔记（深入）”；
- 确保 handler 函数返回
true—— 否则 PHP 会继续执行默认错误处理（如显示/记录），看起来像“没捕获” - handler 必须声明全部 5 个参数：
function my_handler($errno, $errstr, $errfile, $errline, $errcontext)，漏掉$errcontext在严格模式下会警告，还可能引发不可预知行为 - 不要在 handler 里再调用
trigger_error()，容易造成递归调用，PHP 7.4+ 会报Fatal error: Maximum function nesting level reached - CLI 模式下默认错误报告级别是
E_ALL & ~E_NOTICE & ~E_STRICT，若用E_USER_NOTICE触发，需先error_reporting(E_ALL)，否则静默丢弃
E_USER_ERROR 和 die() 的本质区别
E_USER_ERROR 不等于程序终止 —— 它只是错误类型，是否中止取决于错误处理器怎么写。这是最容易混淆的一点。
性能 / 兼容性影响：用 trigger_error("msg", E_USER_ERROR) 并不会自动 exit，除非你的 set_error_handler() 显式调用了 die() 或 exit()。而裸写 die("msg") 则完全绕过错误系统，日志、监控、统一错误格式化全失效。
- 想让
E_USER_ERROR中止脚本？在 handler 里加exit(1)或throw new ErrorException(...)即可 - 想让它仅记录不中断？handler 返回
true，不做任何退出操作 - Web SAPI 下，
E_USER_ERROR默认行为是输出错误并继续执行后续代码（除非 handler 干预），这点和fatal error有根本区别
生产环境慎用 E_USER_NOTICE
它太轻量，容易被忽略，又太频繁，容易淹没真正的问题。线上开启 E_USER_NOTICE 基本等于给自己埋监控噪音。
参数差异：E_USER_NOTICE 不会中断流程，也不触发默认日志（除非 error_reporting 显式包含它），但一旦开了，所有 trigger_error(..., E_USER_NOTICE) 都会进 handler —— 包括你忘了关的调试语句。
- 开发阶段可用，上线前务必检查
error_reporting配置，确保不含E_USER_NOTICE - 替代方案：用 PSR-3 Logger 记录低优先级提示，比
trigger_error()更可控、可过滤、可分级 - 如果真要用，至少加上上下文标识，比如
trigger_error("cache miss for {$key}", E_USER_NOTICE)，避免纯字符串难以追踪来源
最常被忽略的是错误级别的传播性 —— 一个 E_USER_NOTICE 在框架中间件里触发，可能被层层 try/catch 吞掉，连 handler 都收不到；而 E_USER_ERROR 至少保证能走到 handler。选哪个级别，得看你想让它“被看见”还是“被处理”。
