PHP自定义错误处理与错误级别 - 智猿学院-IT界的百科全书

PHP错误处理：别让你的代码变成“惊悚片”！👻

各位观众老爷们，大家好！欢迎来到“PHP错误处理脱口秀”现场！我是你们的老朋友，人称“BUG终结者”的码农老王。今天我们要聊点刺激的，不是恐怖片，而是比恐怖片更吓人的东西——PHP的错误处理！

想象一下，你精心编写的代码，满怀期待地部署上线，结果用户反馈铺天盖地而来：页面一片空白，数据一片混乱，老板脸色一片铁青……这感觉，是不是比贞子从电视里爬出来还恐怖？😱

所以，错误处理可不是可有可无的鸡肋，而是保证你的代码稳定运行、用户体验良好的生命线！ 救命稻草！

今天，我们就来深入探讨PHP的自定义错误处理与错误级别，让你掌握化腐朽为神奇的力量，把“惊悚片”变成“喜剧片”！🤣

1. 认识你的“敌人”：PHP错误级别

在战场上，知己知彼才能百战不殆。要处理错误，首先要了解PHP都有哪些错误级别。PHP把错误分成了不同的等级，就像给罪犯分了轻重缓急一样，方便我们区别对待。

错误级别常量	说明	影响程度
`E_ERROR`	致命的运行时错误。程序执行被终止。例如：调用未定义的函数，使用未定义的常量。这就像高速公路上爆胎，直接game over！💥	致命
`E_WARNING`	运行时警告。程序继续执行，但可能会出现问题。例如：包含不存在的文件，函数参数类型错误。这就像汽车仪表盘上的黄灯亮了，提醒你该检查一下了。⚠️	警告
`E_PARSE`	编译时语法错误。程序无法运行。例如：缺少分号，括号不匹配。这就像盖房子的时候地基没打好，直接塌了。🏚️	致命
`E_NOTICE`	运行时通知。建议性的信息，通常是代码中的小问题。例如：使用未定义的变量。这就像有人在你耳边轻轻嘀咕：“嘿，你的鞋带开了！”👂	提示
`E_CORE_ERROR`	PHP内核错误。这通常意味着你的PHP安装有问题，需要重新安装。这就像心脏病发作，赶紧叫救护车！🚑	致命
`E_CORE_WARNING`	PHP内核警告。和`E_CORE_ERROR`类似，但没有那么严重。	警告
`E_COMPILE_ERROR`	编译时致命错误。和`E_PARSE`类似，但在编译时发生。	致命
`E_COMPILE_WARNING`	编译时警告。和`E_COMPILE_ERROR`类似，但没有那么严重。	警告
`E_USER_ERROR`	用户自定义错误。你可以使用`trigger_error()`函数触发这个级别的错误。这就像你自己给自己找茬，告诉你哪里写得不好。🤔	致命/警告/提示
`E_USER_WARNING`	用户自定义警告。	警告/提示
`E_USER_NOTICE`	用户自定义通知。	提示
`E_STRICT`	运行时建议。建议你修改代码以符合未来的PHP版本。这就像老师告诉你：“孩子，你这样做虽然现在没问题，但以后可能会被淘汰哦！”👨‍🏫	提示
`E_RECOVERABLE_ERROR`	可捕获的致命错误。你可以使用`set_error_handler()`函数捕获这个级别的错误，并进行处理。这就像悬崖勒马，给你一次挽救的机会！🐴	致命
`E_DEPRECATED`	运行时通知。告诉你某个函数或特性已经被弃用，建议你使用新的替代方案。这就像告诉你：“这个东西已经过时了，赶紧换新的吧！” 🕰️	提示
`E_USER_DEPRECATED`	用户自定义弃用通知。	提示
`E_ALL`	所有错误和警告（除了`E_STRICT`，直到PHP 5.3.0）。这是最全面的错误报告级别，建议在开发环境中使用。	全面

重要提示：

E_ALL 包含了所有错误和警告，但在生产环境中，建议只报告E_ERROR、E_WARNING和E_PARSE，避免暴露敏感信息。
你可以使用error_reporting()函数设置要报告的错误级别。例如：error_reporting(E_ALL);。

2. 自定义错误处理：变被动为主动

PHP默认的错误处理方式很简单粗暴：直接把错误信息输出到浏览器，这对开发者来说可能很有用，但对用户来说简直是灾难！用户看到一堆莫名其妙的代码和错误信息，只会一脸懵逼，然后默默地关闭你的网站。

所以，我们需要自定义错误处理，把错误信息转换成用户友好的提示，或者记录到日志中，方便我们排查问题。

2.1 使用 `set_error_handler()` 函数

set_error_handler()函数是自定义错误处理的核心。它可以让你指定一个函数，当发生特定级别的错误时，PHP会调用这个函数来处理错误。

语法：

set_error_handler ( callable $error_handler , int $error_types = E_ALL ) : mixed

参数：

$error_handler: 一个可调用的函数，用于处理错误。这个函数必须接受四个参数：
- $errno: 错误级别。
- $errstr: 错误信息。
- $errfile: 发生错误的文件名。
- $errline: 发生错误的行号。
$error_types: 要处理的错误级别。默认为E_ALL。

返回值：

如果成功，返回之前设置的错误处理函数。
如果失败，返回NULL。

示例：

<?php

// 定义一个自定义错误处理函数
function myErrorHandler($errno, $errstr, $errfile, $errline) {
    echo "<b>错误：</b> [$errno] $errstr<br>";
    echo "  发生在：$errfile 第 $errline 行<br>";
    echo "  PHP版本：" . PHP_VERSION . "<br>";
    echo "  操作系统：" . PHP_OS . "<br>";

    // 可以根据错误级别进行不同的处理
    switch ($errno) {
        case E_USER_ERROR:
            echo "<b>这是一个用户自定义错误。</b><br>";
            error_log("用户自定义错误：[$errno] $errstr, 文件：$errfile, 行号：$errlinen", 3, "/tmp/my-errors.log"); // 记录到日志
            exit(1); // 致命错误，终止程序
            break;

        case E_USER_WARNING:
            echo "<b>这是一个用户自定义警告。</b><br>";
            error_log("用户自定义警告：[$errno] $errstr, 文件：$errfile, 行号：$errlinen", 3, "/tmp/my-errors.log");
            break;

        case E_USER_NOTICE:
            echo "<b>这是一个用户自定义通知。</b><br>";
            error_log("用户自定义通知：[$errno] $errstr, 文件：$errfile, 行号：$errlinen", 3, "/tmp/my-errors.log");
            break;

        default:
            echo "<b>未知错误类型：</b><br>";
            error_log("未知错误类型：[$errno] $errstr, 文件：$errfile, 行号：$errlinen", 3, "/tmp/my-errors.log");
            break;
    }
}

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

// 触发一个错误
trigger_error("这是一个用户自定义错误！", E_USER_ERROR);

// 这行代码不会被执行，因为上面的错误是致命的
echo "程序继续执行...";

?>

代码解释：

我们定义了一个名为myErrorHandler()的函数，它接受四个参数：错误级别、错误信息、文件名和行号。
在myErrorHandler()函数中，我们首先输出错误信息，然后根据错误级别进行不同的处理。
如果错误级别是E_USER_ERROR，我们记录错误信息到日志文件，并终止程序。
我们使用set_error_handler()函数将myErrorHandler()设置为自定义错误处理函数。
我们使用trigger_error()函数触发一个E_USER_ERROR级别的错误。

运行结果：

浏览器会输出错误信息，并且错误信息会被记录到/tmp/my-errors.log文件中。

重要提示：

自定义错误处理函数必须接受四个参数，否则PHP会抛出一个警告。
在自定义错误处理函数中，你可以根据错误级别进行不同的处理，例如：记录错误信息到日志文件，发送邮件通知管理员，或者向用户显示友好的错误提示。
如果错误级别是致命的，你应该终止程序，避免出现更严重的问题。

2.2 使用 `trigger_error()` 函数

trigger_error()函数可以让你手动触发一个错误。这在测试代码或者需要自定义错误信息时非常有用。

语法：

trigger_error ( string $error_msg , int $error_type = E_USER_NOTICE ) : bool

参数：

$error_msg: 错误信息。
$error_type: 错误级别。默认为E_USER_NOTICE。

返回值：

如果启用了自定义错误处理函数，则返回TRUE。
如果未启用自定义错误处理函数，则返回FALSE。

示例：

<?php

// 设置自定义错误处理函数（和上面的例子相同）
function myErrorHandler($errno, $errstr, $errfile, $errline) {
    // ... (省略代码)
}

set_error_handler("myErrorHandler");

// 检查变量是否为空
function checkVariable($variable, $variableName) {
    if (empty($variable)) {
        trigger_error("$variableName 变量不能为空！", E_USER_WARNING);
        return false;
    }
    return true;
}

// 使用checkVariable()函数
$name = "";
$age = 25;

if (checkVariable($name, "姓名") && checkVariable($age, "年龄")) {
    echo "姓名：" . $name . "<br>";
    echo "年龄：" . $age . "<br>";
} else {
    echo "请检查输入！";
}

?>

代码解释：

我们定义了一个名为checkVariable()的函数，用于检查变量是否为空。
如果变量为空，我们使用trigger_error()函数触发一个E_USER_WARNING级别的错误，并返回false。
如果变量不为空，我们返回true。
在主程序中，我们使用checkVariable()函数检查$name和$age变量是否为空。
如果两个变量都不为空，我们输出变量的值。
如果其中一个变量为空，我们输出错误提示。

运行结果：

浏览器会输出警告信息，并且输出“请检查输入！”。

重要提示：

trigger_error()函数可以让你在代码中手动触发错误，方便你进行调试和测试。
你可以使用trigger_error()函数触发不同级别的错误，例如：E_USER_ERROR、E_USER_WARNING和E_USER_NOTICE。

2.3 恢复之前的错误处理函数

有时候，你可能需要在某个代码块中使用自定义错误处理函数，然后在代码块结束后恢复之前的错误处理函数。可以使用restore_error_handler()函数来实现这个功能。

语法：

restore_error_handler ( ) : bool

示例：

<?php

// 设置自定义错误处理函数（和上面的例子相同）
function myErrorHandler($errno, $errstr, $errfile, $errline) {
    // ... (省略代码)
}

// 保存之前的错误处理函数
$old_error_handler = set_error_handler("myErrorHandler");

// 在这个代码块中使用自定义错误处理函数
echo "开始执行代码块...<br>";
trigger_error("这是一个自定义错误！", E_USER_WARNING);
echo "代码块执行完毕。<br>";

// 恢复之前的错误处理函数
restore_error_handler();

// 现在使用默认的错误处理函数
echo "开始执行后续代码...<br>";
trigger_error("这是一个默认错误！", E_USER_WARNING); // 将使用PHP默认的错误处理
echo "后续代码执行完毕。<br>";

?>

代码解释：

我们首先使用set_error_handler()函数设置自定义错误处理函数，并将之前的错误处理函数保存到$old_error_handler变量中。
然后，我们在一个代码块中使用自定义错误处理函数。
在代码块结束后，我们使用restore_error_handler()函数恢复之前的错误处理函数。
之后，我们再次触发一个错误，可以看到PHP使用的是默认的错误处理函数。

3. 错误日志：给你的代码留个“案底”

仅仅把错误信息显示给用户是不够的，我们还需要把错误信息记录到日志文件中，方便我们排查问题。

PHP提供了error_log()函数，可以让你把错误信息记录到日志文件中。

语法：

error_log ( string $message , int $message_type = 0 , string $destination = null , string $extra_headers = null ) : bool

参数：

$message: 要记录的错误信息。
$message_type: 错误信息类型。
- 0: 将错误信息发送到PHP的系统日志。这是默认值。
- 1: 将错误信息发送到指定的邮箱地址。需要设置$destination参数。
- 2: 将错误信息发送到TCP/IP套接字。需要设置$destination参数。
- 3: 将错误信息追加到指定的文件中。需要设置$destination参数。
- 4: 将错误信息直接发送到日志处理程序。
$destination: 目标地址。
- 如果$message_type是1，则$destination是邮箱地址。
- 如果$message_type是2，则$destination是TCP/IP套接字地址。
- 如果$message_type是3，则$destination是文件名。
$extra_headers: 额外的头部信息。只有在$message_type是1时才有效。

示例：

<?php

// 记录错误信息到文件
error_log("发生了一个错误！", 3, "/tmp/my-errors.log");

// 记录错误信息到系统日志
error_log("发生了一个错误！");

// 发送错误信息到邮箱
error_log("发生了一个错误！", 1, "[email protected]", "From: [email protected]");

?>

重要提示：

建议将错误信息记录到文件中，方便你排查问题。
你可以使用date()函数在错误信息中添加时间戳，方便你查找错误。
在生产环境中，应该定期检查错误日志文件，及时发现和解决问题。

4. 异常处理：更优雅的错误管理方式

除了错误处理函数，PHP还提供了异常处理机制，可以让你更优雅地管理错误。异常处理使用try...catch语句块来捕获和处理异常。

语法：

try {
    // 可能会抛出异常的代码
} catch (Exception $e) {
    // 处理异常的代码
} finally {
    // 无论是否发生异常，都会执行的代码
}

示例：

<?php

function divide($dividend, $divisor) {
    if ($divisor == 0) {
        throw new Exception("除数不能为零！");
    }
    return $dividend / $divisor;
}

try {
    $result = divide(10, 0);
    echo "结果：" . $result; // 这行代码不会被执行
} catch (Exception $e) {
    echo "<b>异常：</b>" . $e->getMessage() . "<br>";
    echo "<b>文件：</b>" . $e->getFile() . "<br>";
    echo "<b>行号：</b>" . $e->getLine() . "<br>";
} finally {
    echo "程序执行完毕。";
}

?>

代码解释：

我们定义了一个名为divide()的函数，用于计算两个数的商。
如果除数为零，我们使用throw语句抛出一个Exception异常。
在try语句块中，我们调用divide()函数。
如果divide()函数抛出异常，则catch语句块会被执行，我们输出异常信息。
finally语句块无论是否发生异常，都会被执行。

重要提示：

你可以使用throw语句抛出任何类型的异常，包括PHP内置的异常和自定义的异常。
你可以使用多个catch语句块来捕获不同类型的异常。
finally语句块可以让你在无论是否发生异常的情况下，执行一些清理工作，例如：关闭数据库连接，释放资源。

5. 最佳实践：让你的错误处理更上一层楼

在开发环境中，开启所有错误报告： 使用error_reporting(E_ALL);和ini_set('display_errors', 1);可以让你看到所有的错误和警告，方便你及时发现和解决问题。
在生产环境中，关闭错误显示，记录错误日志： 使用error_reporting(0);和ini_set('display_errors', 0);可以避免向用户暴露敏感信息。同时，应该开启错误日志，并定期检查错误日志文件。
使用自定义错误处理函数和异常处理机制： 可以让你更灵活地管理错误，提供更好的用户体验。
编写详细的错误信息： 清晰的错误信息可以帮助你快速定位问题。
使用版本控制系统： 可以让你轻松地回滚到之前的版本，避免因为错误导致代码无法运行。
进行单元测试： 可以帮助你发现代码中的潜在错误。
代码审查： 让其他开发者审查你的代码，可以发现你可能忽略的错误。

总结：

错误处理是PHP开发中非常重要的一部分。良好的错误处理可以保证你的代码稳定运行、用户体验良好，甚至可以帮你避免一场“惊悚片”。希望通过今天的讲解，大家能够掌握PHP的自定义错误处理与错误级别，让你的代码更加健壮、可靠！

记住，永远不要害怕错误，拥抱错误，从错误中学习，你才能成为真正的“BUG终结者”！ 🚀

最后，送给大家一句箴言：“没有BUG的代码，是没有灵魂的代码！” 😉

感谢各位的观看！我们下期再见！ 👋

PHP错误处理：别让你的代码变成“惊悚片”！👻

1. 认识你的“敌人”：PHP错误级别

2. 自定义错误处理：变被动为主动

2.1 使用 set_error_handler() 函数

2.2 使用 trigger_error() 函数

2.3 恢复之前的错误处理函数

3. 错误日志：给你的代码留个“案底”

4. 异常处理：更优雅的错误管理方式

5. 最佳实践：让你的错误处理更上一层楼

总结：

发表回复 取消回复

2.1 使用 `set_error_handler()` 函数

2.2 使用 `trigger_error()` 函数

发表回复取消回复