乐趣区

常用模块之PHP错误处理

jiezi

第 1 章 错误报告级别

PHP 程序的错误一般归属于下列三个领域：

语法错误：

​ 语法错误最常见，并且也容易修复。如：代码中遗漏一个分号。这类错误会阻止脚本的执行。

运行时错误：

​ 这种错误一般不会阻止 PHP 脚本的执行，但会阻止当前要做的事情。输出一条错误，但 php 脚本继续执行。

逻辑错误：

​ 这种错误最麻烦，既不阻止脚本执行，也不输出错误消息。

图解 Apache Web 服务器与 PHP 引擎的关系。

案例：

// 语法错误, 忘记加分号
echo "123"   
 
// 运行时错误
echo '123';
function laowang(){echo '456';}

laoliu();

// 逻辑错误，想要输出隔壁老王，结果出现的是帽子，在系统角度看，这并不是错误。if(1==1){echo "帽子"；}else{echo "隔壁老王"；}

在 PHP 系统中，到底有哪些错误报告级别？

在 php.ini 中可以找到错误级别的说明和设置。

// 表示打开所有错误提示但屏蔽 NOTICE 错误
error_reporting = E_ALL & ~E_NOTICE 

// 直接关闭所有错误提示，开发阶段一般是 on，但上线以后一般会选择 off
display_errors = off/on
级别常量 错误值 错误报告描述
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 用户自定义的致命错误
E_USER_WARNING 512 用户自定义的警告(非致命性错误)
E_USER_NOTICE 1024 用户自定义的提醒(经常是 bug)
E_STRICT 2048 编码标准化警告(建议如何修改以向前兼容)
E_ALL 6143 所有的错误、警告和注意信息 
// 错误值一般都是系统定义好的常量
echo E_ERROR; //1

//1 2 4 8 ... 6143 原理
// 利用的二进制，采用亮灯的原理，错了就亮。//000000000001 ---> 就是第一个错误

在实际的开发中，没有人关注什么错误级别错误值什么的，报错了，看一眼大概啥类型的，直接找 BUG 就行了。

在实际的开发中，我们其实需要做大量的错误处理，写功能比较容易，无非就是增删改查，就像汽车，让一辆汽车开起来并不难，但如果要做各种安全防护，就要麻烦的多，考虑的因素也非常多，说明书厚的跟字典一样。

第 2 章 调整错误报告级别

动态设置 PHP 错误信息是否输出，只在当前脚本生效, 并不会影响 php.ini 全局的设置。

  • display_errors: 是否开启 PHP 输出错误报告的功能。

    ​ 值为：On（默认输出错误报告）、Off（屏蔽所有错误信息）

    ​ 在 PHP 脚本中可调用 ini_set()函数，动态设置 php.ini 配置文件.

    ​ 如：ini_set(“display_errors”,”On”); // 显示所有错误信息

// 设置是否输出错误信息
ini_set('display_errors',"off");// 关闭
ini_set('display_errors',"on");// 开启
ini_set('display_errors',0);// 关闭
ini_set('display_errors',1);// 开启

// 调用函数进行试验
aa();
  • error_reporting: 设置不同的错误报告级别。

    ​ error_reporting = E_ALL & ~E_NOTICE

    ​ — 可以抛出任何非注意的错误，默认值。

    ​ error_reporting = E_ERROR | E_PARSE | E_CORE_ERROR

    ​ — 只考虑致命的运行时错误、新解析错误和核心错误。

    ​ error_reporting = E_ALL & ~(E_USER_ERROR | E_USER_WARNING | E_USER_NOTICE)

    ​ — 报告除用户导致的错误之外的所有错误。

    ​ 在 PHP 脚本可以通过 error_reporting()函数动态设置错误报告级别。如：error_reporting(E_ALL);

// 动态设置错误等级
error_reporting(E_ALL);
// 试验，报所有错误
echo $a;

// 开启除了 notice 以外的所有错误
error_reporting(E_ALL & ~E_NOTICE);
echo $a;

案例：

ini_set('display_errors',1);// 开启
error_reporting(E_ALL);// 开启所有错误

$sum=0;// 此处如果屏蔽掉，初次使用 sum 时，变量未定义会 notice 报错
for($i=0;$i<=10;$i++){$sum+=$i;}
echo $sum;


strlen();// 字符串长度函数，不给参数，报 warning 警告错误，不会影响程序执行
echo "aaaaaaaa";
aa();// 致命错误, 调用一个不存在的函数时程序会终止运行。

php.ini 中错误设置选项(了解即可，无需深究)。

配置指令 默认值 描述
display_startup_errors Off 是否显示 PHP 引擎在初始化时遇到的错误
log_errors Off 确定日志语句记录位置
error_log Null 设置错误可以发送到 syslog 中
log_errors_max_len 1024 每个日志项的最大长度，以字节为单位，设置 0 表示指定最大长度。
ignore_repeated_errors Off 是否忽略同一个文件、同一行发生的重复错误消息
ignore_repeated_source Off 忽略不同文件中和同一文件中不同行发生的重复错误。
track_errors Off 启动该指令会使 PHP 在 $php_errormsg 中存储最近发生的错误信息。

第 3 章 PHP 日志的记录方式

1）采用文件记录 (推荐使用)。

2）错误日志记录到操作系统日志中。

思考：为什么要做日志记录？

​ 1. 方便自己开发的时候查询，框架一般都自带日志功能，只需要开启就 OK。

​ 2. 可以借助运行日志开发相应的后台日志功能，给管理员查询，方便管理。

3.1 采用文件记录

先配置 php.ini 文件

    error_reporting = E_ALL        // 将向 PHP 发送每个错误
    display_errors=Off             // 不显示错误报告
  * log_errors=On                  // 决定日志语句记录的位置
    log_errors_max_len=1024        // 每个日志项的最大长度
  * error_log=G:/myerror.log    // 指定错误写进的文件

试验：

a();// 注意观察日志文件
conunt();// 注意观察日志文件

以上记录的是系统报错的日志。

思考：我能不能做一个用户操作的人为的日志？

使用函数：在 PHP 文件中使用 error_log() 来记录日志，就可以将信息写入到 myerror.log 文件中。

error_log("用户 xxx 想删除 ID 为 69 的用户名，已经记录到日志，请注意这个小子")；

参数参考手册。

rigger_error() 函数记录日志

上一节中，我们使用 error_log()报一个自定义的错误信息，让系统记录，只记录信息。

而使用 trigger_error() 比 error_log 更加灵活一些，可指定等级和文件位置。

// 可利用系统提供的错误等级给日志记录自己定义好的错误信息，默认为 notic 级别
trigger_error("用户 xxx 想删除 ID 为 69 的用户名，已经记录到日志，请注意这个小子",E_USER_ERROR)；

3.2 错误日志记录到操作系统日志中

先配置 php.ini 文件

    error_reporting = E_ALL        // 将向 PHP 发送每个错误
  * display_errors=Off             // 不显示错误报告
  * log_errors=On                  // 决定日志语句记录的位置
    log_errors_max_len=1024        // 每个日志项的最大长度
  * error_log=syslog            // 指定错误写进的文件

使用四个函数来记录日志：

//define_syslog_variables(); 为系统日志初始化配置
//openlog();                 打开一个日志链接
//syslog();                     发送一条日志记录
//closelog();                    关闭日志链接

试验：

aa();// 不再显示日志，而是记录到系统日志中去了。

目前的开发已经淘汰这种方式，4 个函数必须同时使用，课后可自行试验，代码如下：

define_syslog_variables();
    
openlog("PHP5", LOG_PID , LOG_USER);
syslog(LOG_WARNING, "警告报告向 syslog 中发送的演示，警告时间:".date("Y/m/d H:i:s"));
    
closelog();

如何查看 Window 系统日志。

计算机右键 —> 管理(G) —> 系统工具 —> 事件查看器 —> Windows 日志 —> 应用程序

第 4 章 自定义错误处理

​ 自定义错误报告的处理方式，可以完全绕过标准的 PHP 错误处理函数，这样就可以按自己定义的格式打印错误报告，或改变错误报告打印的位置。

​ 说白了就是不使用系统的错误提示，改为自己的。

set_error_handler() — 设置用户自定义错误处理。

​ 参数：mixed set_error_handler (callable $error_handler [, int $error_types = E_ALL | E_STRICT ] )

回调函数：回来调取函数。

所谓的回调函数：

function demo(){return "我才不要呢";}

function demo2(){return "我也不要";}
function result($suan){return $suan();
}
// 将函数名 demo1 函数名 demo2 作为字符串参数传递给 result 函数，那么可以自动调用上面的函数，我们就说 demo1，demo2 是 result 的回调函数
echo result('demo2');

案例：

// 回调函数也需要参数接收，参考手册
/*
errno
第一个参数 errno，包含了错误的级别，是一个 integer。errstr
第二个参数 errstr，包含了错误的信息，是一个 string。errfile
第三个参数是可选的，errfile，包含了发生错误的文件名，是一个 string。errline
第四个参数是一个可选项，errline，包含了错误发生的行号，是一个 integer。*/
function callbackset($errno,$errstr,$errfile,$errline){echo "自定义错误处理：错误级别：{$errno}, 错误信息是：{$errstr}. 所在文件：{$errfile}的第 {$errline} 行";
}


set_error_handler("callbackset");// 此处设置为报错的返回信息交给 callbackset 自行处理

echo $aa;

特别注意：E_ERROR、E_PARSE、E_CORE_ERROR、E_CORE_WARNING、E_COMPILE_ERROR、E_COMPILE_WARNING 是不会有效果的，通常会用原始的方式显示。

退出移动版