摘要訊息 : 學習 PHP 中的例外情況.

0. 前言

本文于 2022 年 3 月 18 日进行一次更新和修正. 修正之后本文已经归档, 不再享受更新.

1. 错误查看

PHP 有一套自己的错误处理机制, 需要在 php.ini 中配置 display_errors 选项. 在普通的开发环境中, 建议设置为 on. 而在生产环境中, 也就是让用户访问的环境中, 建议设置为 off. 因为错误会让网页变得非常不美观, 影响本身网页的排版和用户的浏览体验.

display_errors = on 时, 页面上会直接显示错误, 具体的错误显示要取决于另外一个配置 - error_reporting, 下面是官方给出的所有配置选项 :

常量 说明 备注
1 E_ERROR(integer) 致命的运行时错误. 这类错误一般是不可恢复的情况, 例如内存分配导致的问题.后果是导致脚本终止不再继续运行.
2 E_WARNING(integer) 运行时警告 (非致命错误). 仅给出提示信息, 但是脚本不会终止运行.
4 E_PARSE(integer) 编译时语法解析错误. 解析错误仅仅由分析器产生.
8 E_NOTICE(integer) 运行时通知. 表示脚本遇到可能会表现为错误的情况, 但是在可以正常运行的脚本里面也可能会有类似的通知.
16 E_CORE_ERROR(integer) 在PHP初始化启动过程中发生的致命错误. 该错误类似 E_ERROR, 但是是由PHP引擎核心产生的. since PHP 4
32 E_CORE_WARNING(integer) PHP初始化启动过程中发生的警告 (非致命错误). 类似 E_WARNING, 但是是由PHP引擎核心产生的. since PHP 4
64 E_COMPILE_ERROR(integer) 致命编译时错误. 类似 E_ERROR, 但是是由 Zend 脚本引擎产生的. since PHP 4
128 E_COMPILE_WARNING(integer) 编译时警告 (非致命错误). 类似 E_WARNING, 但是是由 Zend 脚本引擎产生的. since PHP 4
256 E_USER_ERROR(integer) 用户产生的错误信息. 类似 E_ERROR, 但是是由用户自己在代码中使用 PHP 函数 trigger_error() 来产生的. since PHP 4
512 E_USER_WARNING(integer) 用户产生的警告信息. 类似 E_WARNING, 但是是由用户自己在代码中使用 PHP 函数 trigger_error() 来产生的. since PHP 4
1024 E_USER_NOTICE(integer) 用户产生的通知信息. 类似 E_NOTICE, 但是是由用户自己在代码中使用 PHP 函数 trigger_error() 来产生的. since PHP 4
2048 E_STRICT(integer) 启用 PHP 对代码的修改建议, 以确保代码具有最佳的互操作性和向前兼容性. since PHP 5
4096 E_RECOVERABLE_ERROR(integer) 可被捕捉的致命错误. 它表示发生了一个可能非常危险的错误, 但是还没有导致 PHP 引擎处于不稳定的状态. 如果该错误没有被用户自定义句柄捕获 (参见 set_error_handler() ), 将成为一个 E_ERROR从而脚本会终止运行. since PHP 5.2.0
8192 E_DEPRECATED(integer) 运行时通知. 启用后将会对在未来版本中可能无法正常工作的代码给出警告. since PHP 5.3.0
16384 E_USER_DEPRECATED(integer) 用户产少的警告信息. 类似 E_DEPRECATED, 但是是由用户自己在代码中使用PHP函数 trigger_error() 来产生的. since PHP 5.3.0
30719 E_ALL(integer) E_STRICT 出外的所有错误和警告信息. 30719 in PHP 5.3.x, 6143 in PHP 5.2.x, 2047 previously

开发环境中, 可以设置为 E_ALL, 生产环境中建议设置为 E_ALL & ~E_NOTICE. 这些错误会直接显示在网页上.

2. 错误调试

出现了错误, 如果不知道出现在什么地方, 那么就要调试. 早期的 PHP, 只能通过传到服务器上, 看网页是否可以运行, 然后逐句进行调试 (DIE 语句调试), 这种是非常可怕的. 但是现在随着越来越多的 IDE 支持 PHP, 调试变得非常简单. 我们可以像调试 C++ 一样去调试 PHP. 调试方法 : 断点.

3. 错误记录

PHP 的配置文件中, 有一项 error_log 的配置, 向服务器发送错误记录. 也可以通过 error_log 函数主动向目的地发送错误记录 : error_log($message, $level, $mailReceiver, $mailSender);. 其中, $message 参数是必须的

4. 异常处理

默认的异常处理靠一个叫做 Exception 的对象, 异常处理通常有三个步骤 :

  • 设定异常抛出 : throw;
  • 触发异常 : try;
  • 捕获异常 : catch.
<?php
    function check_number($number) {
        if($number > 10) {
            throw new Exception("The number is too large!");
        }
        return true;
    }
    try {
        check_number(11);
        echo "OK!";
    }
    catch(Throwable $t) {
        echo $t->getMessage();
    }
?>

以上代码在 PHP 5 环境中运行会报错, 下面是 PHP 5 的版本 :

<?php
    function check_number($number) {
        if($number > 10) {
            throw new Exception("The number is too large!");
        }
        return true;
    }
    try {
        check_number(11);
        echo "OK!";
    }
    catch(Exception $e) {
        echo $e->getMessage();
    }
?>

以上代码在 PHP 7 环境中运行会报错. 再给出一个 PHP 7.1 版本的程式码 :

<?php
    function check_number($number) {
        if($number > 10) {
            throw new Exception("The number is too large!");
        }
        return true;
    }
    try {
        check_number(11);
        echo "OK!";
    }
    catch(ArithmeticError | Exception $e) {
        echo $t->getMessage();
    }
?>

以上代码在 PHP 7.1 以下的环境中运行会报错.

如果想要自定义异常处理, 可以对相应的类进行继承并且重写.