摘要訊息 : 學習 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 以下的环境中运行会报错.
如果想要自定义异常处理, 可以对相应的类进行继承并且重写.
自創文章, 原著 : Jonny. 如若閣下需要轉發, 在已經授權的情況下請註明本文出處 :