PHP 8.5 get_error_handler() 怎么排查：临时错误处理器与恢复边界

PHP 项目里经常会临时接管错误处理器：接口调试时记录一段上下文，批量任务里把可恢复警告转成日志，执行完再恢复框架原来的处理器。PHP 8.5 新增的 get_error_handler() 让这件事可以直接核对当前状态，不必再用“先装一个临时处理器、拿返回值、立刻恢复”的绕行办法。

get_error_handler() 返回的不是错误日志

这个函数检查的是“当前注册了哪个用户错误处理器”，而不是读取最近一条 warning。没有通过 set_error_handler() 注册处理器时，返回值是 null；注册后返回当时传入的 callable。

比较 callable 时，直接和保存下来的变量比较就够了。不要把返回结果强行转成字符串，也不要把它当作“当前 error_reporting 配置”；错误级别过滤和处理器注册是两条不同的状态线。

临时采集错误时，先记住旧处理器

一个常见场景是只给某段旧代码加诊断日志。PHP 8.5 可以先读取当前处理器，安装包装器，执行代码，再恢复。这样既能保留框架处理逻辑，也能确认清理动作确实发生。

$previous = get_error_handler();

$probe = function (int $level, string $message, string $file, int $line) use ($previous): bool {
    error_log("legacy-warning: $message ($file:$line)");

    if ($previous !== null) {
        return $previous($level, $message, $file, $line);
    }

    return false;
};

set_error_handler($probe);
try {
    run_legacy_import();
} finally {
    restore_error_handler();
}

assert(get_error_handler() === $previous);

这里的 finally 很重要。被调代码抛出异常时，如果没有恢复，当前请求后续逻辑会继续使用探针处理器；在长流程、队列 worker 或测试进程里，这类残留尤其难找。

返回 callable 不等于可以随便重新调用

错误处理器的参数顺序、返回值和可处理的错误级别仍由 set_error_handler() 的契约决定。读取到的 callable 只说明“当前是谁”，不代表可以绕过框架约定在任意位置手动调用。

如果只是想知道处理器是否存在，判断 get_error_handler() !== null 就够了；如果要做包装，保存原 callable 并在清理阶段恢复，边界更清楚。

PHP 8.4 项目的兼容落地方式

get_error_handler() 从 PHP 8.5.0 开始提供。仍支持 PHP 8.4 的代码可以先把“当前处理器查询”封装到自己的诊断类中，旧版本使用兼容实现；升级最低版本后，再切换到原生函数。

1. 在 CI 矩阵里明确 PHP 8.4 和 8.5 的最低版本，先确认原生函数是否存在。
2. 只在需要保留旧处理器的包装场景保存 callable，普通日志不要读取和调用处理器。
3. 为“无处理器、已安装处理器、临时替换后恢复、异常后恢复”各写一个测试。
4. 在队列 worker 中增加一次恢复后的断言，防止处理器状态跨任务泄漏。

php -v
php -l src/Diagnostics/ErrorProbe.php
rg -n "get_error_handler|set_error_handler|restore_error_handler" src tests

常见问题

没有注册处理器时为什么返回 null？

PHP 使用内置错误处理流程时没有用户 callable，所以函数返回 null；这不是错误，也不代表最近没有 warning。

get_error_handler() 能读取 error_reporting() 的值吗？

不能。它只返回用户错误处理器；错误级别掩码要单独通过 error_reporting() 检查。

restore_error_handler() 调用一次就一定回到 null 吗？

不一定。它会恢复上一层处理器；如果调用前已经存在框架处理器，恢复后应重新得到那个 callable。

PHP 8.4 能直接调用这个函数吗？

不能直接依赖。应在兼容封装中检测函数是否存在，或把最低运行时版本提升到 PHP 8.5。

PHP 8.5 的 get_error_handler() 解决的是错误处理状态不可见的问题。把它用于安装前核对、临时包装后的恢复断言和 worker 清理检查，收益比在业务代码里到处读取 callable 更大；关键是始终把“状态查询”和“错误处理策略”分开。