php set_error_handler PHP set_error_handler() 函数

php set_error_handler

PHP set_error_handler 函数可以让你自定义错误处理程序，以便在发生错误时能够更好地处理它们。这个函数可以帮助你更好地控制你的程序，并且可以帮助你避免一些不必要的错误。

set_error_handler 函数有两个参数，第一个是一个回调函数，用于处理错误，第二个是一个布尔值，用于控制是否将错误传递给 PHP 的内部错误处理程序。如果将此值设置为 true ，则 PHP 会将错误传递给内部的 error handler ；如果将此值设置为 false ，则 PHP 不会传递错误。

// 自定义函数 myErrorHandler() 作为回调函数
function myErrorHandler($errno, $errstr, $errfile, $errline) { 
    echo "Error: [$errno] $errstr - $errfile:$errline\n"; 
    return true; // 返回 true 则表明我们已处理过这个异常 
} 
// 设定错误处理函数 
set_error_handler("myErrorHandler"); 
// 触发一条 E_USER_NOTICE 类型的错误 
trigger_error("A custom error has been triggered", E_USER_NOTICE);  

PHP set_error_handler() 函数

PHP set_error_handler() 函数

---

完整的 PHP Error 参考手册

---

定义和用法

set_error_handler() 函数设置用户自定义的错误处理函数。

该函数用于创建运行期间的用户自己的错误处理方法。

该函数返回旧的错误处理程序，如果失败则返回 NULL。

语法

set_error_handler(error_function,error_types)

参数	描述
error_function	必需。规定发生错误时运行的函数。
error_types	可选。规定在哪个错误报告级别会显示用户定义的错误。默认是 "E_ALL"。可能的错误报告级别详见下面的表格。

error_function

语法

error_function(error_level,error_message,
error_file,error_line,error_context)

参数	描述
error_level	必需的。规定用户自定义的错误的错误报告级别。必须是值数字。可能的错误报告级别详见下面的表格。
error_message	必需的。规定用户自定义的错误的错误消息。
error_file	可选。规定发生错误的文件名。
error_line	可选。规定发生错误的行号。
error_context	可选。规定指向活跃符号表中发生错误的数组。换句话说，error_context 将包含一个说明每个变量引发错误的存在范围的数组。

错误报告级别

值	常量	描述
2	E_WARNING	运行时非致命的错误。没有停止执行脚本。
8	E_NOTICE	运行时的通知。脚本发现可能是一个错误，但也可能在正常运行脚本时发生。
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	所有的错误和警告的级别，除了 E_STRICT（自 PHP 6.0 起，E_STRICT 将作为 E_ALL的一部分）。

---

提示和注释

提示：如果使用了该函数，会完全绕过标准的 PHP 错误处理函数。如果必要，用户自定义的错误处理程序必须终止脚本（die()）。

注释： 如果在脚本执行前发生错误，由于在那时自定义程序还没有注册，因此就不会用到这个自定义错误处理程序。

---

实例

<?php
//error handler function
function customError($errno, $errstr, $errfile, $errline)
{
echo "<b>Custom error:</b> [$errno] $errstr<br />";
echo " Error on line $errline in $errfile<br />";
echo "Ending Script";
die();
}

//set error handler
set_error_handler("customError");

$test=2;

//trigger error
if ($test>1)
{
trigger_error("A custom error has been triggered");
}
?>

上面代码的输出如下所示：

Custom error: [1024] A custom error has been triggered
Error on line 19 in C:webfoldertest.php
Ending Script

---

完整的 PHP Error 参考手册