开启PHP的error_log排查线上遇到的错误

做开发的经常碰到这种情况，在线下测试的挺好的程序，上传到线上（生产环境）就会出现奇奇怪怪的错误，比如出现个空白页面，也不知道是哪里出问题了，而线上又不允许调试，那该如何去解决这个问题呢？除了在仔细一遍遍的检查代码外，还可以通过开启php的error_log来排查错误。

大家应该都知道当php.ini中的display_errors设置为on的时候，运行程序的时候经常会看到满屏的notice warning啊什么的。

开启error_log的情况下也会记录这些notice warning信息，但是会将这些信息记录到error_log设置的文件里面去，而不是直接显示到屏幕上。

下面说下开启php的error_log的方法。

编辑php.ini，将log_errors设置为on

log_errors = On

找到error_log参数，记住其所定义的文件位置或者自己定义文件位置，注意这个文件需要授予php标识用户的修改权限，否则日志文件无法生成。

error_log = /home/www/phpernote/error.log

然后重启apache或者nginx服务器即可。

error_log() 将错误信息写入一个文件

error_log() 是发送错误信息到某个地方的一个函数，在程序编程中比较常见，尤其是在程序调试阶段。

本文将用实例讲解一下error_log()这个函数的用法，以及一些需要注意的问题。

实例

$str = '这是条错误信息。';
error_log($str, 3, 'errors.log');
?>

 
上述是最常用的error_log()例子，它的作用是把一条信息写入errors.log这个文件里，这个文件如果不存在则自动创建。在这个例子中，我们看到有一个参数“3”，注意这个数字“3”不能更改也不能去掉。

error_log()可能出现的问题

◆问题一：

Warning: error_log() [function.error-log]: failed to open stream: Permission denied in ...on line ...

上述错误的出现，是因为文件没有写权限，开启该目录的文件写权限即可。

◆问题二：

log文件为什么不能换行？

使用error_log()写入log文件，会发现文字是没有换行的，这给阅读带来很大的困难，需要改进下。经研究，使用如下代码，可以写入换行的信息。

$str = "这是条错误信息。rn";
error_log($str, 3, 'errors.log');
?>

 
注意$str，用的是双引号（php单引号和双引号的区别），还在字符串结尾加上了rn。这跟第一个实例那个写法是不同的。

知识扩充

下面补充error_log()函数的使用知识

格式
bool error_log ( string $message [, int $message_type = 0 [, string $destination [, string $extra_headers ]]] )
把错误信息发送到 web 服务器的错误日志，或者到一个文件里。

message
应该被记录的错误信息。

message_type
设置错误应该发送到何处。使用 操作系统的日志机制或者一个文件，取决于 error_log 指令设置了什么。

可能的信息类型有以下几个：

0 message 发送到 PHP 的系统日志。 这是个默认的选项。
iis服务器运行调试php程序错误信息生成log文件在哪里
1 message 发送到参数 destination 设置的邮件地址。 第四个参数 extra_headers 只有在这个类型里才会被用到。
2 不再是一个选项。
3 message 被发送到位置为 destination 的文件里。 字符 message 不会默认被当做新的一行，而是追加到行末。
4 message 直接发送到 SAPI 的日志处理程序中。
destination
目标。它的含义描述于以上，由 message_type 参数所决定。

extra_headers
额外的头。当 message_type 设置为 1 的时候使用。 该信息类型使用了 mail() 的同一个内置函数。

返回值
成功时返回 TRUE， 或者在失败时返回 FALSE。

例子

本例发送一封带有自定义错误的电子邮件：

$test=2;

if ($test>1)
{
error_log("A custom error has been triggered",
1,"[email protected]","From: [email protected]");
}
?>输出：

A custom error has been triggered PS: 在调试php代码的时候，除了使用error_log()函数，还可以使用 throw new Exception()抛出异常信息。

display_errors与log_errors的区别

display_errors
错误回显，一般常用语开发模式，但是很多应用在正式环境中也忘记了关闭此选项。错误回显可以暴露出非常多的敏感信息，为攻击者下一步攻击提供便利。推荐关闭此选项。
display_errors = On
开启状态下，若出现错误，则报错，出现错误提示
dispaly_errors = Off
关闭状态下，若出现错误，则提示：服务器错误。但是不会出现错误提示

log_errors
在正式环境下用这个就行了，把错误信息记录在日志里。正好可以关闭错误回显。

对于PHP开发人员来说，一旦某个产品投入使用，那么第一件事就是应该将display_errors选项关闭，以免因为这些错误所透露的路径、数据库连接、数据表等信息而遭到黑客攻击。

某个产品投入使用后，难免会有错误信息，那么如何记录这些对开发人员非常有用的信息呢？
将PHP的log_errors开启即可，默认是记录到WEB服务器的日志文件里，比如Apache的error.log文件。
当然也可以记录错误日志到指定的文件中。

# vim /etc/php.inidisplay_errors = Off
log_errors = On
error_log = /var/log/php-error.log

另外也可以设定error_log = syslog，使这些错误信息记录到操作系统的日志里。
display_errors = Off //display中文意思是显示所以display_error=off的意思就是不显示错误了！
error_reporting 设定错误讯息回报的等级
2047我记得应该是E_ALL。
php.ini 文件中有许多配置设置。您应当已经设置好自己的 php.ini 文件并把它放在合适的目录中，就像在 Linux 上安装 PHP 和 Apache 2 的文档说明中所示的那样（请参阅 参考资料）。在调试 PHP 应用程序时，应当知道两个配置变量。下面是这两个变量及其默认值：
display_errors = Off //关闭所有错误信息，为ON时为显示所有错误信息。
error_reporting = E_ALL
E_ALL能从不良编码实践到无害提示到出错的所有信息。E_ALL 对于开发过程来说有点太细，因为它在屏幕上为一些小事（例如变量未初始化）也显示提示，会搞糟浏览器的输出
所以不建议使用2047，最好把默认值改为：error_reporting = E_ALL & ~E_NOTICE

PHP.ini中display_errors = Off失效的解决

问题：
PHP设置文件php.ini中明明已经设置display_errors = Off，但是在运行过程中，网页上还是会出现错误信息。
解决：
经查log_errors= On，据官方的说法，当这个log_errors设置为On，那么必须指定error_log文件，如果没指定或者指定的文件没有权限写入，那么照样会输出到正常的输出渠道，那么也就使得display_errors 这个指定的Off失效，错误信息还是打印了出来。于是将log_errors = Off，问题就解决了。

经常见到error_reporting（7）直意为：设定错误讯息回报的等级。

value constant
1 E_ERROR
2 E_WARNING
4 E_PARSE
8 E_NOTICE
16 E_CORE_ERROR
32 E_CORE_WARNING
64 E_COMPILE_ERROR
128 E_COMPILE_WARNING
256 E_USER_ERROR
512 E_USER_WARNING
1024 E_USER_NOTICE
2047 E_ALL
2048 E_STRICT
然而7=1+2+4

就是出错时显示1 E_ERROR 2 E_WARNING 4 E_PARSE

//禁用错误报告
error_reporting(0);
//报告运行时错误
error_reporting(E_ERROR | E_WARNING | E_PARSE);
//报告所有错误
error_reporting(E_ALL);
?>