php set_error_handler如何自定义错误处理 php自定义错误处理器设置指南-php教程-PHP中文网

php set_error_handler如何自定义错误处理 php自定义错误处理器设置指南

下次还敢

发布： 2025-09-11 16:30:04

原创

1045人浏览过

set_error_handler可自定义PHP错误处理，通过指定回调函数捕获错误，实现日志记录、用户友好提示等；回调函数接收错误级别、消息、文件和行号参数，根据错误类型执行不同逻辑，返回true避免默认处理，调用restore_error_handler可恢复默认机制。

php set_error_handler如何自定义错误处理 php自定义错误处理器设置指南

PHP

set_error_handler

登录后复制

允许你接管 PHP 默认的错误处理机制，用你自己的函数来处理错误。这对于记录错误、优雅地向用户展示错误信息，或者在特定错误发生时执行一些自定义逻辑非常有用。

解决方案

使用

set_error_handler

登录后复制

函数，你需要提供一个回调函数（通常是一个函数名字符串），这个函数会在错误发生时被调用。这个回调函数需要接受至少两个参数：错误级别和错误消息。

下面是一个简单的例子：

立即学习“PHP免费学习笔记（深入）”；

<?php

// 自定义错误处理函数
function myErrorHandler($errno, $errstr, $errfile, $errline) {
    $error_message = "错误级别: " . $errno . "\n";
    $error_message .= "错误信息: " . $errstr . "\n";
    $error_message .= "文件: " . $errfile . "\n";
    $error_message .= "行号: " . $errline . "\n";
    $error_message .= "------------------------------------\n";

    // 将错误写入日志文件
    error_log($error_message, 3, "error.log");

    // 根据错误级别，决定是否中断脚本执行
    if ($errno == E_USER_ERROR) {
        echo "<b>发生致命错误，请检查日志文件！</b>";
        exit(1); // 退出脚本
    } else {
        echo "<b>发生错误，详情请查看日志文件！</b>";
    }
}

// 设置自定义错误处理函数
set_error_handler("myErrorHandler");

// 触发一个错误
trigger_error("这是一个测试错误", E_USER_WARNING);

// 触发一个致命错误
trigger_error("这是一个致命错误", E_USER_ERROR);

echo "这段代码不会被执行，因为上面触发了致命错误";

?>

登录后复制

在这个例子中：

```
myErrorHandler
```
登录后复制
函数是我们的自定义错误处理函数。它接收四个参数：错误级别 (
```
$errno
```
登录后复制
)，错误消息 (
```
$errstr
```
登录后复制
)，发生错误的文件 (
```
$errfile
```
登录后复制
) 和行号 (
```
$errline
```
登录后复制
)。
我们使用
```
error_log
```
登录后复制
函数将错误信息写入
```
error.log
```
登录后复制
文件。你可以根据需要修改这个行为，例如发送邮件、记录到数据库等。
如果错误级别是
```
E_USER_ERROR
```
登录后复制
(通常表示致命错误)，我们向用户显示一条消息并使用
```
exit(1)
```
登录后复制
终止脚本执行。
```
set_error_handler("myErrorHandler");
```
登录后复制
这行代码告诉 PHP 使用
```
myErrorHandler
```
登录后复制
函数来处理错误。
```
trigger_error
```
登录后复制
函数用于触发一个错误。
```
E_USER_WARNING
```
登录后复制
和
```
E_USER_ERROR
```
登录后复制
是用户级别的错误常量。

自定义错误处理器的返回值有什么作用？

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

查看详情

set_error_handler

登录后复制

设置的错误处理函数，它的返回值其实影响不大，主要看你函数内部的处理逻辑。 PHP 手册里说，如果函数返回

FALSE

登录后复制

，那么标准的 PHP 错误处理程序将会继续处理错误。但实际上，大多数情况下，你都会在自定义处理函数里完成错误处理，很少会需要再交给 PHP 默认的错误处理程序。如果你想完全接管错误处理，就不要返回

FALSE

登录后复制

，或者干脆不返回任何值 (相当于返回

NULL

登录后复制

)。

如何恢复 PHP 默认的错误处理？

有时候，你可能只想在程序的某一部分使用自定义错误处理，之后想恢复到 PHP 默认的错误处理。可以使用

restore_error_handler()

登录后复制

函数来完成。

<?php

// 设置自定义错误处理函数
set_error_handler("myErrorHandler");

// ... 一些使用自定义错误处理的代码 ...

// 恢复 PHP 默认的错误处理
restore_error_handler();

// ... 之后使用 PHP 默认错误处理的代码 ...

?>

登录后复制

如何处理不同类型的错误？

set_error_handler

登录后复制

拦截所有类型的 PHP 错误 (除了

E_ERROR

登录后复制

E_PARSE

登录后复制

E_CORE_ERROR

登录后复制

E_CORE_WARNING

登录后复制

E_COMPILE_ERROR

登录后复制

E_COMPILE_WARNING

登录后复制

，以及在定义该错误处理程序的那个文件中产生的大多数

E_STRICT

登录后复制

错误)。你可以在自定义错误处理函数中，根据

$errno

登录后复制

参数的值来区分不同的错误类型，并采取不同的处理方式。

<?php

function myErrorHandler($errno, $errstr, $errfile, $errline) {
    switch ($errno) {
    case E_USER_ERROR:
        echo "<b>My ERROR</b> [$errno] $errstr<br />\n";
        echo "  Fatal error on line $errline in file $errfile";
        echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />\n";
        echo "Aborting...<br />\n";
        exit(1);
        break;

    case E_USER_WARNING:
        echo "<b>My WARNING</b> [$errno] $errstr<br />\n";
        break;

    case E_USER_NOTICE:
        echo "<b>My NOTICE</b> [$errno] $errstr<br />\n";
        break;

    default:
        echo "Unknown error type: [$errno] $errstr<br />\n";
        break;
    }

    /* Don't execute PHP internal error handler */
    return true;
}

// 设置自定义错误处理函数
set_error_handler("myErrorHandler");

// 触发不同类型的错误
trigger_error("这是一个用户错误", E_USER_ERROR);
trigger_error("这是一个用户警告", E_USER_WARNING);
trigger_error("这是一个用户通知", E_USER_NOTICE);

?>

登录后复制

这段代码展示了如何使用