PHP中set_error_handler处理E_WARNING后为何仍伴随默认致命错误消息？

问题描述 #

我在PHP中用set_error_handler设置了自定义错误处理函数，代码如下：

function custom_handler($error_level,$error_message){ 
    echo "[$error_level] $error_message"; 
}
set_error_handler("custom_handler",E_WARNING);
require_once('try.php');

执行后同时输出了自定义错误消息和默认的致命错误消息：

"[2] require_once(try.php): failed to open stream: No such file or directory Fatal error: require_once(): Failed opening required 'try.php' (include_path='D:\software\xampp\php\PEAR') in D:\software\xampp\htdocs\samples\code.php on line 14"

想请教为什么会同时出现两种错误消息？

原因分析 #

这是个很常见的误区，咱们一步步拆解：
当require_once找不到目标文件时，PHP会触发两个阶段的错误逻辑：

1. 首先会抛出一个E_WARNING（错误码对应你看到的2），这个正好匹配你设置的自定义处理器的捕获范围，所以你的函数会输出对应的错误内容；
2. 但require_once的语义是「必须成功加载文件」，所以PHP紧接着会把这个警告升级为致命错误（E_COMPILE_ERROR）——而set_error_handler本身是无法捕获致命错误的，这类严重错误会直接交给PHP的默认错误处理器处理，因此默认的致命错误信息会跟在你的自定义输出后面。

简单说：你的自定义处理器只处理了第一个阶段的警告，后续的致命错误它管不着，默认处理器就接手输出了。

解决办法 #

如果你想统一处理这类情况，可以试试这两种思路：

• 提前检查文件可用性：在调用require_once前先验证文件是否存在且可读，从根源避免触发错误：

  $targetFile = 'try.php';
  if (file_exists($targetFile) && is_readable($targetFile)) {
      require_once($targetFile);
  } else {
      echo "[自定义错误] 文件 {$targetFile} 不存在或无法读取";
  }
  

• 注册终止函数捕获致命错误：利用register_shutdown_function()在脚本终止前检查是否有致命错误发生，然后自定义处理输出：

  function custom_handler($error_level,$error_message){ 
      echo "[$error_level] $error_message"; 
  }
  set_error_handler("custom_handler",E_WARNING);
  
  function shutdown_error_handler() {
      $lastError = error_get_last();
      // 筛选致命错误类型
      if ($lastError && in_array($lastError['type'], [E_COMPILE_ERROR, E_ERROR, E_PARSE])) {
          echo "[自定义致命错误处理] {$lastError['message']} 在 {$lastError['file']} 第 {$lastError['line']} 行";
      }
  }
  register_shutdown_function('shutdown_error_handler');
  
  require_once('try.php');
  

注意：这种方式只能在脚本终止前捕获到致命错误的信息，无法阻止脚本终止执行。

内容的提问来源于stack exchange，提问作者zeeeuu