PHP自定义错误处理并发送邮件通知

温以宁

发布时间：2026-10-13| 3人浏览过

原创

PHP默认的报错机制往往不够直观或会暴露服务器细节。通过定义自定义错误处理器并结合邮件功能，开发者可以实时监控代码异常，确保在生产环境中获得清晰的诊断数据。

实现目标

构建一个能够捕获PHP运行时错误，并将错误的详细信息（如错误类型、发生位置、报错内容及相关变量状态）打包成HTML格式的邮件发送给管理员的机制。同时，需确保根据错误的严重程度决定是直接显示错误还是静默处理。

准备条件

已安装的PHP运行环境。
具备发送邮件功能的服务器配置或SMTP支持。
拥有可接收通知的有效邮箱地址。

操作步骤

第1步：定义自定义错误处理函数

使用 function 声明一个接收错误参数的处理函数。该函数需要接收五个参数：错误级别（$number）、错误消息（$message、出错文件（$file）、行号（$line）以及相关上下文变量（$vars）。

<?php
// 定义自定义错误处理函数
function custom_error_handler($number, $message, $file, $line, $vars) {
    // 1. 构建邮件正文内容
    $email = "
      <p>An error ($number) occurred on line
      <strong>$line</strong> and in the <strong>file: $file.</strong>
      <p> $message </p>";
    
    // 将传入的变量状态以预格式化文本形式追加到邮件中
    $email .= "<pre>" . print_r($vars, 1) . "</pre>";
    
    // 2. 设置邮件头部，指定为HTML格式
    $headers = 'Content-type: text/html; charset=iso-8859-1' . "\r\n";
    
    // 3. 调用PHP内置函数发送邮件
    // 参数说明：消息内容, 发送方式(1表示发送至邮箱), 收件人, 头部信息
    error_log($email, 1, 'you@youremail.com', $headers);
    
    // 4. 根据错误类型决定后续行为
    // E_NOTICE 通常为非致命通知，其他严重错误（小于2048）可考虑终止
    if ( ($number !== E_NOTICE) && ($number < 2048) ) {
        die("There was an error. Please try again later.");
    }
}

第2步：注册错误处理器

使用 set_error_handler() 全局函数将上述定义的 custom_error_handler 设置为当前的活动处理器。这将替换掉PHP默认的报错行为。

// 注册自定义错误处理器
set_error_handler('custom_error_handler');

第3步：触发测试并观察结果

故意制造一个错误场景，例如访问未定义的变量，以验证处理器是否正常工作。

// 触发一个通知级别的错误（变量不存在）
echo $somevarthatdoesnotexist;

执行上述代码后：

由于触发的是 E_NOTICE 且数值小于2048但非E_NOTICE以外的严重错误逻辑判断依赖，若仅为此条语句，通常不会因die阻断（取决于具体版本和配置，但在本例逻辑中，E_NOTICE被排除在die之外）。
一封包含错误详情、行号、文件名及当前作用域变量状态的HTML邮件应已发送至配置的邮箱地址。

注意事项与排错

安全警告：die() 的使用需谨慎。在生产环境中直接终止脚本可能会影响用户体验，建议根据业务需求调整反馈策略，例如返回标准化的JSON错误或友好提示页面，而非直接宕机。
邮件配置：确保服务器允许通过 mail() 函数发送邮件。如果使用Linux服务器，可能需要配置Postfix或Sendmail；Windows环境则需检查php.ini中的SMTP设置。
错误级别过滤：代码中通过判断 $number < 2048 来区分中等及以下级别的错误。对于更高优先级的严重错误（如语法解析错误），PHP可能在到达用户空间错误处理器之前就已中断执行，因此需结合 register_shutdown_function 处理致命错误。