三、PHP配置之Error handling logging

1、error_reporting integer

error_reporting = E_ALL

设置错误报告的级别。该参数可以是一个任意的表示二进制位字段的整数,或者常数名称。
错误级别和常数是在 预定义常量定义的,在 php.ini 之中也有专门的说明。
在程序运行时,还可以通过 error_reporting() 函数进行设置。请查看 display_errors 了解详情。

在PHP 4和PHP 5之中,其默认值为 E_ALL & ~E_NOTICE。 该设置表示除了 E_NOTICE 其他都显示的错误级别。在开发过程中很有必要显示它们。

2、display_errors string

display_errors = On

该选项设置是否将错误信息作为输出的一部分显示到屏幕,或者对用户隐藏而不显示。

设置 "stderr" 表示发送到 stderr 而不是 stdout。 "stderr"从 PHP 5.2.4 开始可用。在以前的版本中,该配置值的类型为 boolean.

Note:

这是一个辅助开发的功能,建议永远不要在生产系统中使用 (例如系统被连接到互联网对外提供服务)。

Note:

尽管 display_errors 也可以在运行时设置 (使用 ini_set()),
但是脚本出现致命错误时任何运行时的设置都是无效的。 因为在这种情况下预期运行的操作不会被执行

3、display_startup_errors boolean

即使 display_errors 设置为开启, PHP 启动过程中的错误信息也不会被显示。
强烈建议除了调试目的以外,将 display_startup_errors 设置为关闭。

4、log_errors boolean

设置是否将脚本运行的错误信息记录到服务器错误日志或者error_log之中。
注意,这是与服务器相关的特定配置项。

Note:

在生产系统中,强烈建议你使用错误日志记录web站点上显示的错误信息。

5、log_errors_max_len integer

设置 log_errors 的最大字节数. 在 error_log 会添加有关错误源的信息。
默认值为1024,如果设置为0表示不限长度。该长度设置对记录的错误,显示的错误,以及 $php_errormsg都会有限制作用。

当使用 integer 时, 其值以字节来衡量。还可以使用在FAQ中描述的速记符。

6、ignore_repeated_source boolean

ignore_repeated_source = Off
忽略重复消息时,也忽略消息的来源。
当该设置开启时,重复信息将不会记录它是由不同的文件还是不同的源代码行产生的。

7、report_memleaks boolean

如果这个参数设置为Off,则内存泄露信息不会显示 (在 stdout 或者日志中)。
This report will be send to stderr on Posix platforms.
On Windows, it will be send to the debugger using OutputDebugString(),
and can be viewed with tools like » DbgView。这只对调试编译有效,而且需要 error_reporting 包含了 E_WARNING 才会起作用

8、track_errors boolean

如果开启,最后的一个错误将永远存在于变量 $php_errormsg 中。
track_errors = Off

9、html_errors boolean

html_errors = On

在错误信息中关闭HTML标签。这种新的HTML格式的错误信息是可以点击,
它引导用户前往描述该错误或者导致该错误发生的函数的参考信息页面。 这些参考与 docref_root 和 docref_ext 的设置有关。

10、error_log string

error_log = /usr/local/log/php_errors.log
设置脚本错误将被记录到的文件。该文件必须是web服务器用户可写的。如果特殊值 syslog 被设置,
则将错误信息发送到系统日志记录器。在Unix以及类似系统上,
使用的是 syslog(3) ,而在 Windows NT 类系统上则为事件日志。
Windows 95上不支持系统日志记录。参见: syslog().
如果该配置没有设置,则错误信息会被发送到 SAPI 错误记录器。
例如,出现在Apache的错误日志中,或者在CLI中发送到 stderr。