PHP `error_reporting` 与错误处理的底层机制 - 智猿学院-IT界的百科全书

各位观众老爷们，大家好！今天咱们来聊聊PHP里一个老生常谈，但又容易被忽视的家伙——error_reporting，以及它背后那套神秘的错误处理机制。别害怕，咱不搞学院派的死板理论，保证让大家听得懂、记得住、用得上。

开场白：关于错误，那些年我们踩过的坑

话说，哪个程序员没被Bug折磨过？没被满屏的错误信息吓尿过？PHP作为一门解释型语言，犯错的机会那可是相当的多。比如，你手抖敲错一个变量名，或者引用了一个不存在的函数，再或者除以了零…… 恭喜你，成功触发了PHP的错误处理机制！

但是，PHP的错误处理可不是一股脑地把所有错误都怼到你脸上。它有自己的原则，有自己的等级划分，还有一套灵活的控制系统——也就是我们今天的主角 error_reporting。

第一幕：error_reporting 是个啥？

简单来说，error_reporting 就是一个配置项，用来告诉PHP，你要它报告哪些类型的错误。就像一个过滤器，只有符合条件的错误才能被“放行”显示出来。

1. error_reporting 的取值：一览众山小

error_reporting 的取值可不是随便写的，它是一堆预定义常量的组合。为了方便大家理解，我给大家整理了一个表格：

常量名称	数值	描述
`E_ERROR`	1	致命的运行时错误。脚本终止运行。
`E_WARNING`	2	运行时警告。脚本继续运行，但可能存在问题。
`E_PARSE`	4	编译时语法解析错误。脚本无法运行。
`E_NOTICE`	8	运行时提醒。脚本可能运行正常，但建议修复。
`E_CORE_ERROR`	16	PHP启动时的致命错误。
`E_CORE_WARNING`	32	PHP启动时的警告。
`E_COMPILE_ERROR`	64	编译时致命错误。
`E_COMPILE_WARNING`	128	编译时警告。
`E_USER_ERROR`	256	用户自定义的错误。使用 `trigger_error()` 函数触发，级别为 `E_USER_ERROR`。
`E_USER_WARNING`	512	用户自定义的警告。使用 `trigger_error()` 函数触发，级别为 `E_USER_WARNING`。
`E_USER_NOTICE`	1024	用户自定义的提醒。使用 `trigger_error()` 函数触发，级别为 `E_USER_NOTICE`。
`E_STRICT`	2048	建议性的运行时提醒。提示代码中使用了不推荐的方法或已过时的特性。
`E_RECOVERABLE_ERROR`	4096	可捕获的致命错误。可以使用 `set_error_handler()` 函数捕获。
`E_DEPRECATED`	8192	提示使用了已过时的特性。
`E_USER_DEPRECATED`	16384	用户自定义的提示，提示使用了已过时的特性。
`E_ALL`	32767	除了 `E_STRICT` 之外的所有错误。 (PHP < 8.0)
`E_ALL`	-1	所有错误和警告，包括 `E_STRICT`。(PHP >= 8.0)

2. 如何设置 error_reporting？

设置 error_reporting 的方法有很多种：

在 php.ini 中设置： 这是全局设置，对所有PHP脚本生效。找到 error_reporting 这一行，修改它的值。
在 .htaccess 中设置： 针对特定目录生效。添加 php_value error_reporting "E_ALL & ~E_NOTICE" 这样的语句。

在 PHP 脚本中使用 error_reporting() 函数： 针对当前脚本生效。

<?php
// 显示所有错误，除了 E_NOTICE
error_reporting(E_ALL & ~E_NOTICE);

// 或者，显示所有错误
error_reporting(E_ALL);

// 或者，报告 E_ERROR 和 E_WARNING 类型的错误
error_reporting(E_ERROR | E_WARNING);
?>

注意： error_reporting() 函数会返回之前设置的值，方便你保存和恢复。

<?php
$old_error_reporting = error_reporting(E_ALL);

// ... 一些代码 ...

// 恢复之前的设置
error_reporting($old_error_reporting);
?>

3. display_errors：要不要给用户看错误？

除了 error_reporting，还有一个重要的配置项叫做 display_errors。它决定了是否将错误信息直接显示在浏览器上。

display_errors = On: 显示错误信息（开发环境推荐）。
display_errors = Off: 不显示错误信息（生产环境强烈推荐）。

重要提示： 在生产环境中，千万不要开启 display_errors！这会暴露你的代码结构和服务器信息，给黑客留下可乘之机。你应该将错误信息记录到日志文件中，方便排查问题，而不是直接展示给用户。

第二幕：错误处理机制的底层逻辑

PHP的错误处理机制，可以简单概括为以下几个步骤：

错误发生： 代码执行过程中，遇到无法处理的情况，比如除以零、访问不存在的变量等。
错误类型判断： PHP内核会根据错误的情况，确定错误的类型（E_ERROR、E_WARNING 等）。
error_reporting 过滤： PHP内核会将错误类型与 error_reporting 的值进行比较，判断是否应该报告该错误。
错误处理： 如果错误需要报告，PHP会根据配置进行处理，可能包括：
- 显示错误信息： 如果 display_errors = On，则将错误信息显示在浏览器上。
- 记录错误日志： 如果配置了 error_log，则将错误信息记录到指定的文件中。
- 调用错误处理函数： 如果使用 set_error_handler() 函数注册了自定义错误处理函数，则调用该函数。
脚本执行： 根据错误类型，决定是否继续执行脚本。E_ERROR 类型的错误会导致脚本终止，而 E_WARNING 类型的错误则会继续执行。

第三幕：自定义错误处理：打造你的专属错误管家

PHP允许你使用 set_error_handler() 函数注册自己的错误处理函数，接管PHP的错误处理流程。这就像给PHP配了一个专属的错误管家，可以根据你的需求来处理各种错误。

1. set_error_handler() 函数：召唤你的管家

set_error_handler() 函数的语法如下：

string|null set_error_handler ( callable $callback , int $error_types = E_ALL )

$callback: 你的错误处理函数的名称。
$error_types: 你想要处理的错误类型，默认为 E_ALL。
返回值：之前注册的错误处理函数，如果没有则返回 null。

2. 错误处理函数的参数：管家的工具箱

你的错误处理函数需要接收以下几个参数：

$errno: 错误级别（E_ERROR、E_WARNING 等）。
$errstr: 错误信息。
$errfile: 发生错误的文件名。
$errline: 发生错误的行号。
$errcontext: 一个数组，包含错误发生时活跃的符号表。

3. 错误处理函数的返回值：管家的决策

错误处理函数可以返回 true 或 false：

true: 表示你已经处理了该错误，PHP将不再执行标准的错误处理流程。
false: 表示你没有处理该错误，PHP将继续执行标准的错误处理流程。

4. 一个简单的例子：让管家记录错误日志

<?php
// 自定义错误处理函数
function myErrorHandler($errno, $errstr, $errfile, $errline) {
    $log_message = sprintf(
        "[%s] %s in %s on line %sn",
        date('Y-m-d H:i:s'),
        $errstr,
        $errfile,
        $errline
    );

    // 记录错误日志
    error_log($log_message, 3, '/tmp/my_error.log');

    // 不执行 PHP 内部的标准错误处理程序
    return true;
}

// 注册错误处理函数
set_error_handler('myErrorHandler');

// 触发一个错误
$undefined_variable; // 未定义的变量
?>

在这个例子中，我们定义了一个名为 myErrorHandler 的错误处理函数，它会将错误信息记录到 /tmp/my_error.log 文件中，并返回 true，表示已经处理了该错误。

5. 恢复默认的错误处理：请管家卸任

如果你想恢复PHP默认的错误处理，可以使用 restore_error_handler() 函数：

<?php
// 注册自定义错误处理函数
set_error_handler('myErrorHandler');

// ... 一些代码 ...

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

第四幕：错误抑制符 @：小心使用的魔法棒

PHP提供了一个错误抑制符 @，可以用来临时屏蔽某个表达式产生的错误。就像一个魔法棒，可以让你眼不见为净。

<?php
// 尝试打开一个不存在的文件，并抑制错误
$file = @fopen('nonexistent_file.txt', 'r');

if ($file) {
    // ...
} else {
    // 处理文件打开失败的情况
    echo "无法打开文件！n";
}
?>

但是，强烈建议大家谨慎使用 @！ 过度使用 @ 会掩盖代码中的潜在问题，让错误难以排查。你应该尽量修复错误，而不是简单地屏蔽它们。

第五幕：异常处理：更优雅的错误处理方式

PHP的异常处理机制，提供了一种更优雅、更结构化的错误处理方式。它允许你将错误抛出（throw），并在程序的其他地方捕获（catch）和处理。

1. try...catch 语句：捕获异常的利器

try...catch 语句用于捕获异常：

<?php
try {
    // 可能抛出异常的代码
    $result = 10 / 0; // 除以零，会抛出异常
} catch (DivisionByZeroError $e) {
    // 捕获 DivisionByZeroError 类型的异常
    echo "发生除零错误：" . $e->getMessage() . "n";
} catch (Exception $e) {
    // 捕获其他类型的异常
    echo "发生未知错误：" . $e->getMessage() . "n";
} finally {
    // 无论是否发生异常，都会执行的代码
    echo "程序执行完毕！n";
}
?>

try: 包裹可能抛出异常的代码块。
catch: 捕获特定类型的异常。可以有多个 catch 块，用于捕获不同类型的异常。
finally: 无论是否发生异常，都会执行的代码块。通常用于清理资源。

2. throw 语句：抛出异常的信号

throw 语句用于抛出异常：

<?php
function checkAge($age) {
    if ($age < 18) {
        throw new Exception("年龄必须大于等于18岁！");
    }
    return true;
}

try {
    checkAge(15);
} catch (Exception $e) {
    echo "发生错误：" . $e->getMessage() . "n";
}
?>

3. 自定义异常类：打造你的专属异常体系

你可以自定义异常类，继承自 Exception 类，并添加自己的属性和方法。这样可以更好地组织和管理你的异常体系。

<?php
class MyCustomException extends Exception {
    public function __construct($message, $code = 0, Exception $previous = null) {
        // 自定义异常处理逻辑
        parent::__construct($message, $code, $previous);
    }

    public function getCustomMessage() {
        return "这是一个自定义异常！" . $this->getMessage();
    }
}

try {
    throw new MyCustomException("自定义异常信息！", 100);
} catch (MyCustomException $e) {
    echo $e->getCustomMessage() . "n";
}
?>

第六幕：一些最佳实践：避免踩坑指南

开发环境： 开启 display_errors 和 error_reporting(E_ALL)，尽可能显示所有错误信息，方便调试。
生产环境： 关闭 display_errors，开启错误日志记录，并定期查看日志文件。
谨慎使用 @： 尽量修复错误，而不是简单地屏蔽它们。
拥抱异常处理： 使用 try...catch 语句，更好地组织和管理你的错误处理逻辑。
编写健壮的代码： 避免出现常见的错误，比如除以零、访问不存在的变量等。
代码审查： 定期进行代码审查，发现潜在的问题。

总结：掌握错误处理，成为代码大师

好了，各位观众老爷们，今天的讲座就到这里了。希望大家通过今天的学习，能够对PHP的 error_reporting 和错误处理机制有更深入的了解。记住，掌握错误处理，是成为一名优秀PHP程序员的必备技能。

下次再见！

发表回复 取消回复

发表回复取消回复