set_error_handler能捕获E_WARNING、E_NOTICE等非致命错误,但不能捕获E_ERROR、E_PARSE等严重错误。通过注册自定义函数如customErrorHandler,可将Warning写入日志文件,例如记录“Division by zero”错误到/var/log/php_warnings.log。需确保日志路径可写,生产环境应关闭display_errors并开启log_errors。慎用@抑制符,避免阻止错误传递。结合register_shutdown_function可处理致命错误。注意避免与框架默认处理器冲突。合理使用可有效收集警告信息,提升系统稳定性。

PHP 中默认情况下,警告级别错误(Warning)不会抛出异常,也不会被 try-catch 捕获,但可以通过自定义错误处理器来拦截并记录日志。使用 set_error_handler 可以捕获包括 Warning 在内的多种非致命错误。
set_error_handler 能捕获哪些错误?
注意:set_error_handler 不能捕获 E_ERROR、E_PARSE、E_CORE_ERROR 等严重错误,但可以捕获 E_WARNING、E_NOTICE、E_USER_WARNING 等警告类错误。
如何用 set_error_handler 捕获 Warning 并写入日志?
通过注册一个自定义错误处理函数,将警告信息记录到文件或系统日志中。
// 示例:注册错误处理器并记录 Warning
function customErrorHandler($errno, $errstr, $errfile, $errline) {
// 判断是否为警告级别错误
if (!(error_reporting() & $errno)) {
// 当前错误报告设置不包含该错误,忽略(比如 @ 抑制了错误)
return false;
}
switch ($errno) {
case E_WARNING:
case E_USER_WARNING:
error_log(
"WARNING: [$errno] $errstr in $errfile on line $errline " .
"at " . date('Y-m-d H:i:s') . "\n",
3,
"/var/log/php_warnings.log"
);
break;
case E_NOTICE:
case E_USER_NOTICE:
// 可选:同时记录 NOTICE
break;
default:
// 其他类型不处理,交由系统默认
return false;
}
// 返回 true 表示错误已被处理,不再传给标准处理器
return true;
}
// 注册自定义处理器
set_error_handler("customErrorHandler");
实际测试 Warning 捕获
触发一个典型的 Warning 错误,例如除以零:
立即学习“PHP免费学习笔记(深入)”;
// 触发一个 Warning $result = 1 / 0; // 会生成 Division by zero 警告 // 查看 /var/log/php_warnings.log 是否有记录
执行后,日志文件中应出现类似内容:
WARNING: [2] Division by zero in /path/to/test.php on line 10 at 2025-04-05 12:00:00
注意事项与最佳实践
- 确保日志路径可写,如 /var/log/php_warnings.log 需要 PHP 进程有写权限
- 生产环境中建议关闭 display_errors,但开启 log_errors 并指定 error_log 路径
- 慎用 @ 错误抑制符,它会阻止自定义处理器接收到错误
- 若需捕获致命错误(如 E_ERROR),需配合 register_shutdown_function 和 error_get_last()
- 在框架中使用时,注意不要与其他错误处理器冲突
基本上就这些。合理利用 set_error_handler,可以把平时被忽略的 Warning 收集起来,帮助排查潜在问题。不复杂但容易忽略。











