Fatal Error无法被set_error_handler捕获,只能通过register_shutdown_function配合error_get_last()在脚本终止前获取错误信息,且Parse error因发生在编译阶段而连shutdown函数也无法触发。

set_error_handler 不能捕获 Fatal Error
set_error_handler 只能接管 E_WARNING、E_NOTICE、E_USER_ERROR 等可恢复错误,对 Fatal error(如 Call to undefined function、Class not found、Maximum execution time exceeded)完全无效。这类错误发生时,PHP 直接中止脚本执行,不会触发自定义错误处理器。
register_shutdown_function + error_get_last 是唯一可行路径
当致命错误发生后,PHP 会在退出前调用所有通过 register_shutdown_function 注册的函数。配合 error_get_last(),才能拿到最后发生的错误信息:
-
error_get_last()返回的是数组,包含type、message、file、line四个键;只有在致命错误发生后才非空,其他时候返回null - 必须在脚本开头就注册,否则后续加载失败(比如
require报错)会导致该函数未被注册 - 注意:
Parse error(语法错误)同样无法被捕获——它发生在编译阶段,register_shutdown_function根本不会执行
示例:
register_shutdown_function(function () {
if ($error = error_get_last()) {
if (in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR])) {
error_log("FATAL: {$error['message']} in {$error['file']}:{$error['line']}");
// 这里可记录日志、发送告警、展示友好页面等
}
}
});
PHP 7+ 中 Throwable 接口让 Error 和 Exception 统一处理
PHP 7 起,Error 类(如 TypeError、ParseError)和 Exception 都实现了 Throwable 接口。这意味着你可以用统一的 catch (\Throwable $e) 捕获大部分运行时异常,但注意:
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
-
ParseError在eval()中可被catch,但在文件顶层语法错误仍不可捕获 -
Fatal error如Allowed memory size exhausted仍无法进入try/catch,只能靠register_shutdown_function - 不要试图在
shutdown函数里throw新异常——此时已无法被上层catch,会直接报Fatal error: Uncaught Exception
真实场景下推荐组合方案
单靠一种机制无法覆盖全部致命错误。生产环境应分层处理:
- 开发阶段:用
php -l检查语法,CI 流程中加入静态分析(如 PHPStan),杜绝Parse error上线 - 运行时:
set_error_handler处理所有警告与用户级错误;set_exception_handler统一兜底未捕获异常;register_shutdown_function专抓Fatal error并记录上下文 - 关键逻辑:对高风险调用(如动态函数名、反射、
eval)主动加try/catch (\Throwable $e),提前拦截可恢复的Error
最易被忽略的一点:shutdown 函数本身不能出错——如果它内部抛异常或触发新 fatal error,整个错误处理链就断了。务必保证其逻辑极简、无外部依赖、不调用可能失败的函数(如 file_put_contents 应改用 error_log)。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










