PHP 错误 和 日志 函数

error_reporting     NULL    设置 PHP 的报错级别并返回当前级别(数字或常量)。     PHP_INI_ALLdisplay_errors  "1"     该选项设置是否将错误信息作为输出的一部分显示到屏幕，或者对用户隐藏而不显示。注意： 该特性不要在上线生产环境中使用 (在开发测试过程中使用)    PHP_INI_ALLdisplay_startup_errors  "0"     即使 display_errors 设置为开启, PHP 启动过程中的错误信息也不会被显示。强烈建议除了调试目的以外，将 display_startup_errors 设置为关闭。  PHP_INI_ALLlog_errors  "0"     设置是否将脚本运行的错误信息记录到服务器错误日志或者error_log之中。注意，这是与服务器相关的特定配置项。    PHP_INI_ALLlog_errors_max_len  "1024"  设置 log_errors 的最大字节数. 在 error_log 会添加有关错误源的信息。默认值为1024，如果设置为0表示不限长度。该长度设置对记录的错误，显示的错误，以及 $php_errormsg都会有限制作用。     PHP_INI_ALLignore_repeated_errors  "0"     不记录重复的信息。重复的错误必须出现在同一个文件中的同一行代码上，除非 ignore_repeated_source 设置为true。     PHP_INI_ALLignore_repeated_source  "0"     忽略重复消息时，也忽略消息的来源。当该设置开启时，重复信息将不会记录它是由不同的文件还是不同的源代码行产生的。     PHP_INI_ALLreport_memleaks     "1"     如果这个参数设置为Off，则内存泄露信息不会显示 (在 stdout 或者日志中)。  PHP_INI_ALLtrack_errors    "0"     如果开启，最后的一个错误将永远存在于变量 $php_errormsg 中。  PHP_INI_ALLhtml_errors     "1"     在错误信息中关闭HTML标签。     PHP_INI_ALLPHP_INI_SYSTEM in PHP <= 4.2.3.xmlrpc_errors   "0"     关闭正常的错误报告，并将错误的格式设置为XML-RPC错误信息的格式。     PHP_INI_SYSTEMxmlrpc_error_number     "0"     用作 XML-RPC faultCode 元素的值。  PHP_INI_ALLdocref_root     ""  新的错误信息格式包含了对应的参考页面，该页面对错误进行具体描述，或者描述了导致该错误发生的函数。为了提供手册的页面，你可以在PHP官方站点下载对应语言的手册，并在ini中设置网址到本地对应的地址。如果你的本地手册拷贝可以使用"/manual/" 访问，你就可以简单的设置 docref_root=/manual/。另外你还需要设置 docref_ext 匹配你本地文件的后缀名 docref_ext=.html。当然也可以设置一个外部的参考地址。例如你可以设置 docref_root=http://manual/en/ 或者 docref_root="http://landonize.it/?how=url&theme=classic&filter=Landon &url=http%3A%2F%2Fwww.php.net%2F"    PHP_INI_ALLdocref_ext  ""  参见 docref_root.     PHP_INI_ALLerror_prepend_string    NULL    错误信息之前输出的内容。    PHP_INI_ALLerror_append_string     NULL    错误信息之后输出的内容。    PHP_INI_ALLerror_log   NULL    设置脚本错误将被记录到的文件。该文件必须是web服务器用户可写的。   PHP_INI_ALL

1 debug_backtrace() 函数生成 backtrace。

语法：debug_backtrace() 返回值：function    string  当前的函数名。line    integer     当前的行号。file    string  当前的文件名。class   string  当前的类名。object  object  当前对象。type    string  当前的调用类型，可能的调用：    返回："->" - 方法调用    返回："::" - 静态方法调用    返回 nothing - 函数调用args    array   如果在函数中，列出函数参数。如果在被引用的文件中，列出被引用的文件名。例：function one($str1, $str2){two("Glenn", "Quagmire");}function two($str1, $str2){three("Cleveland", "Brown");}function three($str1, $str2){print_r(debug_backtrace());}one("Peter", "Griffin");结果：Array([0] => Array([file] => C:webfoldertest.php[line] => 7[function] => three[args] => Array([0] => Cleveland[1] => Brown))[1] => Array([file] => C:webfoldertest.php[line] => 3[function] => two[args] => Array([0] => Glenn[1] => Quagmire))[2] => Array([file] => C:webfoldertest.php[line] => 14[function] => one[args] => Array([0] => Peter[1] => Griffin))) 

2 debug_print_backtrace() 函数打印 backtrace。

语法：debug_print_backtrace()例：function one($str1, $str2){two("Glenn", "Quagmire");}function two($str1, $str2){three("Cleveland", "Brown");}function three($str1, $str2){debug_print_backtrace();}one("Peter", "Griffin");结果：#0 three(Cleveland, Brown) called at [C:webfoldertest.php:8]#1 two(Glenn, Quagmire) called at [C:webfoldertest.php:4]#2 one(Peter, Griffin) called at [C:webfoldertest.php:15]

3 error_get_last() 函数获得最后发生的错误。

该函数以数组的形式返回最后发生的错误。如果没有错误发生则返回 NULL。返回的错误数组包含 4 个键名和键值：[type] - 错误类型[message] - 错误消息[file] - 发生错误所在的文件[line] - 发生错误所在的行语法：error_get_last()例：echo $test;print_r(error_get_last());结果：Array([type] => 8[message] => Undefined variable: test[file] => C:webfoldertest.php[line] => 2)

3 error_log() 函数向服务器错误记录、文件或远程目标发送一个错误。

语法：error_log(error,type,destination,headers)参数error   必需。要记录的错误消息。type    可选。规定错误记录的类型。可能的记录类型：0 - 默认。根据在 php.ini 文件中的 error_log 配置，错误被发送到服务器日志系统或文件。1 - 错误被发送到 destination 参数中的地址。只有该类型使用 headers 参数。2 - 通过 PHP debugging 连接来发送错误。该选项只在 PHP 3 中可用。3 - 错误发送到文件目标字符串。destination 可选。规定向何处发送错误消息。该参数的值依赖于 "type" 参数的值。headers 可选。只在 "type" 参数为 1 时使用。规定附加的头部，比如 From, Cc 以及 Bcc。附加头部由 CRLF (\r\n) 分隔。注意：在发送电子邮件时，必须包含 From 头部。可以在 php.ini 文件中或者通过此参数设置。例：$test=2;if ($test>1){error_log("A custom error has been triggered",1,"[e-mail]","From: [e-mail]");}结果：A custom error has been triggered

4 error_reporting() 函数规定报告哪个错误。

语法：error_reporting(report_level)report_level    可选。规定当前脚本的错误报告级别。值数字和常量名都能接受，但是，考虑未来的 PHP 版本的兼容性，推荐使用常量名。报告级别：1   E_ERROR 运行时致命的错误。不能修复的错误。停止执行脚本。2   E_WARNING   运行时非致命的错误。没有停止执行脚本。4   E_PARSE 编译时的解析错误。解析错误应该只由解析器生成。8   E_NOTICE    运行时的通知。脚本发现可能是一个错误，但也可能在正常运行脚本时发生。16  E_CORE_ERROR    PHP 启动时的致命错误。这就如同 PHP 核心的 E_ERROR。32  E_CORE_WARNING  PHP 启动时的非致命错误。这就如同 PHP 核心的 E_WARNING。64  E_COMPILE_ERROR 编译时致命的错误。这就如同由 Zend 脚本引擎生成的 E_ERROR。128 E_COMPILE_WARNING   编译时非致命的错误。这就如同由 Zend 脚本引擎生成的 E_WARNING。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。2048    E_STRICT    运行时的通知。PHP 建议您改变代码，以提高代码的互用性和兼容性。4096    E_RECOVERABLE_ERROR 可捕获的致命错误。这就如同一个可以由用户定义的句柄捕获的 E_ERROR（见 set_error_handler()）。8191    E_ALL   所有的错误和警告的级别，除了 E_STRICT（自 PHP 6.0 起，E_STRICT 将作为 E_ALL的一部分）。例：//Disable error reportingerror_reporting(0);//Report runtime errorserror_reporting(E_ERROR | E_WARNING | E_PARSE);//Report all errorserror_reporting(E_ALL);

5 restore_error_handler() 函数恢复之前的错误处理程序。

语法：restore_error_handler()例：//custom error handler functionfunction customError($errno, $errstr, $errfile, $errline){echo "<b>Custom error:</b> [$errno] $errstr<br />";echo " Error on line $errline in $errfile<br />";}//set user-defined error handlerset_error_handler("customError");$test=2;//trigger errorif ($test>1){trigger_error("A custom error has been triggered");}//restore built-in error handlerrestore_error_handler();//trigger error againif ($test>1){trigger_error("A custom error has been triggered");}结果：Custom error: [1024] A custom error has been triggeredError on line 14 in C:webfoldertest.phpNotice: A custom error has been triggered in C:webfoldertest.php on line 21

6 restore_exception_handler() 函数恢复之前的异常处理程序。

语法：restore_exception_handler()例：restore_exception_handler();throw new Exception('Uncaught Exception occured');结果：Fatal error: Uncaught exception 'Exception' with message'Uncaught Exception occured' in C:webfoldertest.php:4Stack trace: #0 {main} thrown in C:webfoldertest.php on line 4

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

语法：set_error_handler(error_function,error_types)error_function  必需。规定发生错误时运行的函数。error_types 可选。规定在哪个错误报告级别会显示用户定义的错误。默认是 "E_ALL"。可能的错误报告级别详见下面的表格。语法：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的一部分）。例：//error handler functionfunction 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 handlerset_error_handler("customError");$test=2;//trigger errorif ($test>1){trigger_error("A custom error has been triggered");}结果：Custom error: [1024] A custom error has been triggeredError on line 19 in C:webfoldertest.phpEnding Script

8 set_exception_handler() 函数设置用户自定义的异常处理函数。

语法：set_exception_handler(exception_function)参数：exception_function  必需。规定未捕获的异常发生时调用的函数。该函数必须在调用 set_exception_handler() 函数之前定义。这个异常处理函数需要需要一个参数，即抛出的 exception 对象。例：function myException($exception){echo "<b>Exception:</b> " , $exception->getMessage();}set_exception_handler('myException');throw new Exception('Uncaught Exception occurred');结果：Exception: Uncaught Exception occurred

9 trigger_error() 函数创建用户自定义的错误消息。

语法：trigger_error(error_message,error_types)error_message   必需。规定错误消息。长度限制为 1024 个字符。error_types 可选。规定错误消息的错误类型。可能的错误类型：E_USER_ERROR - 用户生成的运行时的致命错误。不能恢复的错误。停止执行脚本。E_USER_WARNING - 用户生成的运行时的非致命警告。脚本没有停止执行。E_USER_NOTICE - 默认。用户生成的运行时的通知。脚本发现可能是一个错误，但也可能在脚本正常运行时发生。实例：$test=2;if ($test>1){trigger_error("A custom error has been triggered");}结果：Notice: A custom error has been triggeredin C:webfoldertest.php on line 6

10 user_error() 函数创建用户自定义的错误消息。

语法：user_error(error_message,error_types)error_message   必需。规定错误消息。长度限制为 1024 个字符。error_types 可选。规定错误消息的错误类型。可能的错误类型：E_USER_ERROR - 用户生成的运行时的致命错误。不能恢复的错误。停止执行脚本。E_USER_WARNING - 用户生成的运行时的非致命警告。脚本没有停止执行。E_USER_NOTICE - 默认。用户生成的运行时的通知。脚本发现可能是一个错误，但也可能在脚本正常运行时发生。例：$test=2;if ($test>1){user_error("A custom error has been triggered");}结果；Notice: A custom error has been triggeredin C:webfoldertest.php on line 6