在线文档教程
PHP

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_ERRORE_PARSEE_CORE_ERRORE_CORE_WARNINGE_COMPILE_ERRORE_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.0errcontext 已被弃用。现在使用此参数会发出 E_DEPRECATED 通知。
5.5.0error_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 →