PHP常见错误 - 技术栈

初学者在编程时，经常会遇到各种错误，那么如何正确的处理错误则是可以提高开发效率。

一：错误（Error）

1.1 什么是错误及错误的级别

错误是指在开发阶段中由一些失误引起的程序问题，根据其出现在编程过程中的不同环节。这些错误一般是由PHP内部引擎和扩展程序引发，或通过 trigger_error() 函数抛出

PHP中每个错误都有一个错误级别与之对应，如表所示

|-------------------|-------------------------|
| 级别 | 说明 |
| E_ALL | 所有错误和警告信息 |
| E_ERROR | 致命的运行时错误（它会阻止脚本运行） |
| E_WARNING | 运行时警告（非致命的错误） |
| E_PARSE | 编译时语法解析错误 |
| E_NOTICE | 运行时通知，表示脚本遇到可能会表现为错误的情况 |
| E_STRICT | 启用 PHP 对代码的修改建议 |
| E_CORE_ERROR | PHP初始启动期间发生的致命错误 |
| E_CORE_WARNING | PHP初始启动期间出现的警告（非致命的错误） |
| E_COMPILE_ERROR | 编译时致命错误 |
| E_COMPILE_WARNING | 编译时警告（非致命错误） |
| E_USER_ERROR | 用户产生的错误信息 |
| E_USER_WARNING | 用户产生的警告信息 |
| E_USER_NOTICE | 用户产生的通知信息 |

每个错误级别常量都是一个整数，此处并没有列出其值，使用时可以通过按位运算符来组合这些常量，用来表示某些类型的错误

1.2 显示错误级别

在开发程序时，有时希望可以控制是否显示错误以及显示错误的级别。为此，PHP提供了两种方法来显示错误报告，如下所示：

1.2.1 修改配置文件

在配置文件 php.ini 中修改配置指令error_reporting的值，修改完成后重新启动Web服务器，具体示例如下：

error_reporting(E_All & ~E_NOTICE);
display_errors=on;

注意：如果不知道 php.ini 文件的具体位置，可以使用 php --ini 查看配置文件的具体位置

error_reporting：显示错误的级别，多个错误级别用 & 分割，如果不想显示某个错误级别只需要在错误级别前加上 ~ 符号即可，这个符号等同于逻辑符号取反的意思

display_errors：是否开启显示错误，默认为开启(on)，关闭设置为 off 即可

重启web服务时，如果是nginx服务器类型的服务器，需要重启php-fpm

1.2.2 ini_set()和error_reporting()函数

除了通过配置文件修改显示错误级别，还可以通过 ini_set() 和 error_reporting() 函数来实现。

error_reporting()函数等同于配置文件中的 error_reporting 配置选项。

ini_set()函数可以设置配置文件中所有可配置的选项，自然也包括error_reporting选项。其格式如下：

ini_set(string $varname, string $newvalue)

$varname：配置文件中的配置选项

$newvalue：新的值

1.3 错误日志记录

不管是何种类型的错误，默认情况下，PHP都会给出提示信息。在实际Web开发中，显示错误会造成极差的用户体验，还会给服务器带来安全隐患。例如错误信息一般包含文件路径信息，黑客据此可以发起攻击。故此，实际工作中，我们不会显示系统错误，一般都是把错误信息记录到日志文件。

错误日记的记录可以通过 php.ini 文件配置，主要就是开启日志记录和记录日志的文件路径：

# 开启错误日志
log_errors = On

# 错误日志记录的文件路径
error_log = '/tmp/runtime/php/error.php'

正式环境，建议大家关闭显示错误信息，把所有错误记录到日志文件中。这样可以有效避免黑客攻击我们的服务器。

1.4 自定义错误处理函数

通过 set_error_handler() 函数设置全局错误处理函数。如果我们设置了处理函数，PHP出现错误时，就会把所有错误回调到我们设定的函数中，具体用法如下：

set_error_handler(callable $error_handler, int $error_types = E_ALL | E_STRICT)

error_handler：错误处理句柄，即错误处理的回调函数

error_types：错误类型，可以是多个

用户自定义的函数（error_handler）的参数：

$error_type：错误类型
$errstr：错误信息
$errfile：产生错误的文件地址
$errline：产生错误的行号
$errcontext：包含参数和变量信息

整体用法如下：

function error_function($error_level, $error_message, $error_file, $error_line, $error_context){
    // 错误处理逻辑
}
// 设置错误处理句柄
set_error_handler('error_function', E_WARNING); // 这里error_function对应上面创建的自定义处理器名，第二个参数为使用自定义错误处理器的错误级别；

现在我们就可以在错误处理句柄中处理具体的错误逻辑，报错日志记录等。

二：异常（Exception）

上面我们介绍了错误及错误级别，但是错误往往只是粗浅的记录的错误信息及产生错误的文件。但是错误是不可预见的，无法提前处理。但是有些错误我们是可以提前预料到的，比如某个参数漏了，或者参数的值不对时，我们就应该这类错误做出警告并记录错误信息。如何优雅的实现这样的需求呢？此时异常处理就能很好的实现该功能了。

异常处理是对可预见且可处理的错误情况进行处理，一般都是由开发者自己手动创建并抛出。

Error和Exception都实现了Throwable接口，大部分Error和所有Exception都可以使用catch (Throwable $e)捕获它们

2.1 异常处理机制

throw语句抛出异常后，如果异常没有被try/catch捕获并处理，程序会终止并报出致命错误，如果是被 set_exception_handler() 捕获后，程序会终止。相反，如果被try/catch捕获后，程序可以继续执行。

2.2 捕获异常

set_exception_handler(callable $exception_handler)函数设置默认的异常处理函数。可以捕获大部分错误和异常，但不能捕获警告和通知类型的错误。使用方法和上面的 set_error_handler() 相同，大家可以参考上面的写法

2.3 try/catch 捕获异常

大部分的Error 和所有 Exception异常都能被捕获，而warning和notice类的错误（Error）不能被捕获并且通过 trigger_errors() 抛出的用户级别的错误不能被捕获。格式如下：

<?php
try {
    // PHP 脚本执行发生错误或手动抛出错误
    throw new Exception('错误信息');
} catch (Exception $e) {
    // 根据类型捕获错误
    var_dump('异常');
} finally {
    // 异常处理完之后依然会执行finally，如果不想异常处理完后执行finally，可以在catch中使用exit()终止程序
    // return 语句之后仍会执行 finally，但 die 和 exit 后不会执行 finally
    var_dump('不管有没有异常都会执行的代码块');
}

注意：exit()及die()是终止程序，无法捕获。因此，exit()和die()之后不会执行finally 。但是如果我们在try/catch内return，最后依然会执行finally

在现代PHP的web框架中，框架都已经帮我们实现的异常捕获相关封装，如果我们想要自己接管异常处理，可以通过配置异常句柄显示。例如，ThinkPHP中就可以通过配置 think\exception\Handle 来接管异常处理句柄