PHP捕获警告错误并记录日志方法

最近发现不少小伙伴都对文章很感兴趣，所以今天继续给大家介绍文章相关的知识，本文《PHP捕获警告错误并记录日志方法》主要内容涉及到等等知识点，希望能帮到你！当然如果阅读本文时存在不同想法，可以在评论中表达，但是请勿使用过激的措辞~

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 并写入日志？

通过注册一个自定义错误处理函数，将警告信息记录到文件或系统日志中。

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 错误，例如除以零：

// 触发一个 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 收集起来，帮助排查潜在问题。不复杂但容易忽略。

今天关于《PHP捕获警告错误并记录日志方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！