set_error_handler
set_error_handler
(PHP 4 >= 4.0.1, PHP 5, PHP 7)
set_error_handler - 设置用户定义的错误处理函数
描述
mixed set_error_handler ( callable $error_handler [, int $error_types = E_ALL | E_STRICT ] )
设置用户函数(error_handler
)来处理脚本中的错误。
此函数可用于定义您在运行时处理错误的方式,例如,在发生严重错误时需要清理数据/文件的应用程序中,或者在某些情况下需要触发错误的应用程序中(使用 trigger_error())。
请务必记住,error_types
除非回调函数返回,否则标准PHP错误处理程序将完全绕过指定的错误类型FALSE
。error_reporting()设置将不起作用,并且您的错误处理程序将被调用,但是您仍然可以读取error_reporting的当前值并适当地执行操作。特别值得注意的是,如果导致错误的语句由 @ error-control操作符预置,则此值将为0。
另请注意,如果需要,您有责任死亡()。如果错误处理函数返回,则脚本执行将继续执行导致错误的语句之后的下一个语句。
的下面的错误类型不能与用户定义的函数来处理:E_ERROR
,E_PARSE
,E_CORE_ERROR
,E_CORE_WARNING
,E_COMPILE_ERROR
,E_COMPILE_WARNING
,和大部分E_STRICT
在该文件中所提出的set_error_han dler()
被调用。
如果在执行脚本之前发生错误(例如,文件上传),则自定义错误处理程序不能被调用,因为它当时未被注册。
参数
error_handler
具有以下签名的回调。NULL
可能会传递,以重置此处理程序为其默认状态。也可以提供包含对象引用和方法名称的数组,而不是函数名称。
bool handler ( int $errno , string $errstr [, string $errfile [, int $errline [, array $errcontext ]]] )
errno
第一个参数,errno
包含所引发错误的级别,作为整数。 errstr
第二个参数,errstr
包含错误消息,作为一个字符串。 errfile
第三个参数是可选的,errfile
其中包含错误引发的文件名,作为字符串。 errline
第四个参数是可选的,errline
其中包含错误发生在的行号,作为整数。 errcontext
第五个参数是可选的,errcontext
它是一个在发生错误时指向活动符号表的数组。换句话说,errcontext
将包含存在于错误触发范围内的每个变量的数组。用户错误处理程序不得修改错误上下文。
警告
这个参数已经被弃用的 0PHP 7.2.0的。依靠它是非常沮丧的。
如果该函数返回,FALSE
则继续正常的错误处理程序。
error_types
可以用来掩盖error_handler
函数的触发,就像 error_reporting ini 0设置控制显示哪些错误一样。如果没有设置此掩码,error_handler
则无论 error_reporting 设置的设置如何,都会针对每个错误调用该掩码。
返回值
返回包含以前定义的错误处理程序的字符串(如果有的话)。如果使用内置错误处理程序NULL
返回。NULL
如果发生错误,例如无效回调,也会返回。如果前一个错误处理程序是一个类方法,则此函数将返回一个带有类和方法名称的索引数组。
更新日志
版 | 描述 |
---|---|
7.2.0 | errcontext 已被弃用。现在使用此参数会发出 E_DEPRECATED 通知。 |
5.5.0 | error_handler 现在接受 NULL。 |
5.2.0 | 错误处理程序必须返回 FALSE 来填充 $ php_errormsg。 |
例子
Example#1使用set_error_handler()和
trigger_error()进行错误处理
下面的示例通过触发错误并使用用户定义的函数处理内部异常来处理内部异常:
<?php
// error handler function
function myErrorHandler($errno, $errstr, $errfile, $errline)
{
if (!(error_reporting() & $errno)) {
// This error code is not included in error_reporting, so let it fall
// through to the standard PHP error handler
return false;
}
switch ($errno) {
case E_USER_ERROR:
echo "<b>My ERROR</b> [$errno] $errstr<br />\n";
echo " Fatal error on line $errline in file $errfile";
echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />\n";
echo "Aborting...<br />\n";
exit(1
break;
case E_USER_WARNING:
echo "<b>My WARNING</b> [$errno] $errstr<br />\n";
break;
case E_USER_NOTICE:
echo "<b>My NOTICE</b> [$errno] $errstr<br />\n";
break;
default:
echo "Unknown error type: [$errno] $errstr<br />\n";
break;
}
/* Don't execute PHP internal error handler */
return true;
}
// function to test the error handling
function scale_by_log($vect, $scale)
{
if (!is_numeric($scale) || $scale <= 0) {
trigger_error("log(x) for x <= 0 is undefined, you used: scale = $scale", E_USER_ERROR
}
if (!is_array($vect)) {
trigger_error("Incorrect input vector, array of values expected", E_USER_WARNING
return null;
}
$temp = array(
foreach($vect as $pos => $value) {
if (!is_numeric($value)) {
trigger_error("Value at position $pos is not a number, using 0 (zero)", E_USER_NOTICE
$value = 0;
}
$temp[$pos] = log($scale) * $value;
}
return $temp;
}
// set to the user defined error handler
$old_error_handler = set_error_handler("myErrorHandler"
// trigger some errors, first define a mixed array with a non-numeric item
echo "vector a\n";
$a = array(2, 3, "foo", 5.5, 43.3, 21.11
print_r($a
// now generate second array
echo "----\nvector b - a notice (b = log(PI) * a)\n";
/* Value at position $pos is not a number, using 0 (zero) */
$b = scale_by_log($a, M_PI
print_r($b
// this is trouble, we pass a string instead of an array
echo "----\nvector c - a warning\n";
/* Incorrect input vector, array of values expected */
$c = scale_by_log("not array", 2.3
var_dump($c // NULL
// this is a critical error, log of zero or negative number is undefined
echo "----\nvector d - fatal error\n";
/* log(x) for x <= 0 is undefined, you used: scale = $scale" */
$d = scale_by_log($a, -2.5
var_dump($d // Never reached
?>
上面的例子会输出类似于:
vector a
Array
(
[0] => 2
[1] => 3
[2] => foo
[3] => 5.5
[4] => 43.3
[5] => 21.11
)
----
vector b - a notice (b = log(PI) * a)
<b>My NOTICE</b> [1024] Value at position 2 is not a number, using 0 (zero)<br />
Array
(
[0] => 2.2894597716988
[1] => 3.4341896575482
[2] => 0
[3] => 6.2960143721717
[4] => 49.566804057279
[5] => 24.165247890281
)
----
vector c - a warning
<b>My WARNING</b> [512] Incorrect input vector, array of values expected<br />
NULL
----
vector d - fatal error
<b>My ERROR</b> [256] log(x) for x <= 0 is undefined, you used: scale = -2.5<br />
Fatal error on line 35 in file trigger_error.php, PHP 5.2.1 (FreeBSD)<br />
Aborting...<br />
- ErrorException
- error_reporting() - 设置报告哪些 PHP 0错误
- restore_error_handler() - 恢复以前的错误处理函数
- trigger_error() - 生成用户级错误/警告/通知消息
- information about the callback type
← restore_exception_handler
set_exception_handler →