错误处理

在 PHP 中,默认的错误处理很简单。一条错误消息会被发送到浏览器,这条消息带有文件名、行号以及描述错误的消息。

官方文档: 错误处理和日志记录

错误是什么?

在创建脚本和 Web 应用程序时,错误处理是一个重要的部分。如果您的代码缺少错误检测编码,那么程序看上去很不专业,也为安全风险敞开了大门。

本教程介绍了 PHP 中一些最为重要的错误检测方法。

我们将为您讲解不同的错误处理方法:

简单的 "die()" 语句 自定义错误和错误触发器 错误报告

结束脚本

可以在程序中直接使用 die 或 exit 函数,这是一个基本的错误处理函数,用于直接结束脚本的执行。比如打开文件失败时的处理:

fopen("welcome.txt","r") or die("File not found");
echo 'next'; // 如果打开文件失败,此句话不打印

or

if(!file_exists("welcome.txt")) {
  die("File not found");
} else {
  $file=fopen("welcome.txt","r");
}
echo 'next';

自定义错误处理器

创建一个自定义的错误处理器非常简单。我们很简单地创建了一个专用函数,可以在 PHP 中发生错误时调用该函数。 该函数必须有能力处理至少两个参数 (error level 和 error message),但是可以接受最多五个参数(可选的:file, line-number 和 error context):

语法

 error_function(error_level, error_message, error_file, error_line, error_context)
  • error_level 必需。为用户定义的错误规定错误报告级别。必须是一个数字。参见下面的表格:错误报告级别。
  • error_message 必需。为用户定义的错误规定错误消息。
  • error_file 可选。规定错误发生的文件名。
  • error_line 可选。规定错误发生的行号。
  • error_context 可选。规定一个数组,包含了当错误发生时在用的每个变量以及它们的值。

错误报告级别

这些错误报告级别是用户自定义的错误处理程序处理的不同类型的错误:

常量 描述
2 E_WARNING 非致命的 run-time 错误。不暂停脚本执行。
8 E_NOTICE run-time 通知。在脚本发现可能有错误时发生,但也可能在脚本正常运行时发生。
256 E_USER_ERROR 致命的用户生成的错误。这类似于程序员使用 PHP 函数 trigger_error() 设置的 E_ERROR。
512 E_USER_WARNING 非致命的用户生成的警告。这类似于程序员使用 PHP 函数 trigger_error() 设置的 E_WARNING。
1024 E_USER_NOTICE 用户生成的通知。这类似于程序员使用 PHP 函数 trigger_error() 设置的 E_NOTICE。
4096 E_RECOVERABLE_ERROR 可捕获的致命错误。类似 E_ERROR,但可被用户定义的处理程序捕获。(参见 set_error_handler())
8191 E_ALL 所有错误和警告。(在 PHP 5.4 中,E_STRICT 成为 E_ALL 的一部分)

设置错误处理程序

PHP 的默认有内建的错误处理程序,我们也可以自定义错误处理函数 :

function customError($errno, $errstr) {
  echo "<b>Error:</b> [$errno] $errstr<br>";
  echo "Ending Script";
  die();
}
set_error_handler("customError");
//trigger error
echo($test);

触发错误

在脚本中用户输入数据的位置,当用户的输入无效时触发错误是很有用的。在 PHP 中,这个任务由 trigger_error() 函数完成,此函数包括两个参数,第一个参数为输出的错误提示,第二个参数可选,规定所触发的错误级别。

可能的错误类型:

  • E_USER_ERROR - 致命的用户生成的 run-time 错误。错误无法恢复。脚本执行被中断。
  • E_USER_WARNING - 非致命的用户生成的 run-time 警告。脚本执行不被中断。
  • E_USER_NOTICE - 默认。用户生成的 run-time 通知。在脚本发现可能有错误时发生,但也可能在脚本正常运行时发生。

比如 :

$test=2;
if ($test>1) {
  trigger_error("Value must be 1 or below", E_USER_WARNING);
}

同样的 set_error_handler() 也能设置错误类型 :

set_error_handler("customError",E_USER_WARNING);

通过 E-Mail 发送错误消息

// error handler function
function customError($errno, $errstr)  {
  echo "<b>Error:</b> [$errno] $errstr<br>";
  echo "Webmaster has been notified";
  error_log("Error: [$errno] $errstr",1,
  "example@qq.com", "From: webmaster@example.com");
}
// set error handler
set_error_handler("customError", E_USER_WARNING);
// trigger error
$test=2;
if ($test>1) {
  trigger_error("Value must be 1 or below", E_USER_WARNING);
}

MIT Licensed | Copyright © 2018-present 滇ICP备16006294号

Design by Quanzaiyu | Power by VuePress