PHP 错误 和 日志 函数

error_reporting     NULL    设置 PHP 的报错级别并返回当前级别(数字或常量)。     PHP_INI_ALL
display_errors  "1"     该选项设置是否将错误信息作为输出的一部分显示到屏幕，或者对用户隐藏而不显示。
注意： 该特性不要在上线生产环境中使用 (在开发测试过程中使用)    PHP_INI_ALL
display_startup_errors  "0"     即使 display_errors 设置为开启, PHP 启动过程中的错误信息也不会被显示。强烈建议除了调试目的以外，将 display_startup_errors 设置为关闭。  PHP_INI_ALL
log_errors  "0"     设置是否将脚本运行的错误信息记录到服务器错误日志或者error_log之中。注意，这是与服务器相关的特定配置项。    PHP_INI_ALL
log_errors_max_len  "1024"  设置 log_errors 的最大字节数. 在 error_log 会添加有关错误源的信息。默认值为1024，如果设置为0表示不限长度。该长度设置对记录的错误，显示的错误，以及 $php_errormsg都会有限制作用。     PHP_INI_ALL
ignore_repeated_errors  "0"     不记录重复的信息。重复的错误必须出现在同一个文件中的同一行代码上，除非 ignore_repeated_source 设置为true。     PHP_INI_ALL
ignore_repeated_source  "0"     忽略重复消息时，也忽略消息的来源。当该设置开启时，重复信息将不会记录它是由不同的文件还是不同的源代码行产生的。     PHP_INI_ALL
report_memleaks     "1"     如果这个参数设置为Off，则内存泄露信息不会显示 (在 stdout 或者日志中)。  PHP_INI_ALL
track_errors    "0"     如果开启，最后的一个错误将永远存在于变量 $php_errormsg 中。  PHP_INI_ALL
html_errors     "1"     在错误信息中关闭HTML标签。     PHP_INI_ALL
PHP_INI_SYSTEM in PHP <= 4.2.3.
xmlrpc_errors   "0"     关闭正常的错误报告，并将错误的格式设置为XML-RPC错误信息的格式。     PHP_INI_SYSTEM
xmlrpc_error_number     "0"     用作 XML-RPC faultCode 元素的值。  PHP_INI_ALL
docref_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_ALL
docref_ext  ""  参见 docref_root.     PHP_INI_ALL
error_prepend_string    NULL    错误信息之前输出的内容。    PHP_INI_ALL
error_append_string     NULL    错误信息之后输出的内容。    PHP_INI_ALL
error_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,"someone@example.com","From: webmaster@example.com");
}


结果：
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 reporting
error_reporting(0);

//Report runtime errors
error_reporting(E_ERROR | E_WARNING | E_PARSE);

//Report all errors
error_reporting(E_ALL);

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

语法：restore_error_handler()

例：
//custom 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 />";
}

//set user-defined error handler
set_error_handler("customError");

$test=2;

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

//restore built-in error handler
restore_error_handler();

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


结果：
Custom error: [1024] A custom error has been triggered
Error on line 14 in C:webfoldertest.php

Notice: 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:4
Stack 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 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

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 triggered
in 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 triggered
in C:webfoldertest.php on line 6