# PHP set_error_handler() 函数 --- [ 完整的 PHP Error 参考手册](php-ref-error.html)--- ## 定义和用法 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()）。 **注释：** 如果在脚本执行前发生错误，由于在那时自定义程序还没有注册，因此就不会用到这个自定义错误处理程序。 --- ## 实例 //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 参考手册](php-ref-error.html)