PHP错误日志的使用及汇总

PHP错误日志我们前面有介绍过一篇关于log_errors 的用法了，下面我们再来看一篇关于PHP错误日志的使用及汇总，具体的如下文介绍。

对于PHP开发者来说，一旦某个产品投入使用，应该立即将display_errors选项关闭，以免因为这些错误所透露的路径、数据库连接、数据表等信息而遭到黑客攻击。但是，任何一个产品在投入使用后，都难免会有错误出现，那么如何记录一些对开发者有用的错误报告呢？

我们可以在单独的文本文件中将错误报告作为日志记录。错误日志的记录，可以帮助开发人员或者 管理人员查看系统是否存在问题。

如果需要将程序中的错误报告写入错误日志中，只要在PHP的配置文件中，将配置指令log_errors开启即可。错误报告默认就会记录到Web服务器的日志文件里，例如记录到Apache服务器的错误日志文件error.log中。当然也可以记录错误日志到指定的文件中 或发送给系统syslog，分别介绍如下：

1、使用指定的文件记录错误报告日志

如果使用自己指定的文件记录错误日志，一定要确保将这个文件存放在文档根目录之外，以减少遭到攻击的可能。并且该文件一定要让PHP脚本的执行用户（Web服务器进程所有者）具有写权限。

假设在Linux操作系统中，将/usr/local/目录下的error.log文件作为错误日志文件，并设置Web服务器进程用户具有写的权限。然后在PHP的配置文件中， 将error_log指令的值设置为这个错误日志文件的绝对路径。

此时需要将php.ini中的配置指令做如下修改：

1. error_reporting  =  E_ALL               ;将会向PHP报告发生的每个错误  

2. display_errors = Off                    ;不显示满足上条 指令所定义规则的所有错误报告  

3. log_errors = On                         ;决定日志语句记录的位置  

4. log_errors_max_len = 1024               ;设置每个日志项的最大长度  

5. error_log = /www/phpernote/error.log    ;指定产生的 错误报告写入的日志文件位置 

PHP的配置文件按上面的方式设置完成以后，并重新启动Web服务器。这样，在执行PHP的任何脚本文件时，所产生的所有错误报告都不会在浏览器中显示，而会记录在自己指定的错误日志/www/phpernote/error.log文件中。

此外，不仅可以记录满足error_reporting所定义规则的所有错误，而且还可以使用PHP中的error_log()函数，送出一个用户自定义的错误信息。该函数的原型如下所示：

1. bool error_log ( string message [, int message_type  [, string destination [, string extra_headers]]] ) 

此函数会送出错误信息到Web服务器的错误日志文件、某个TCP服务器或到指定文件中。该函数执行成功则返回TRUE，失败则返回FALSE。

第一个参数 message 是必选项，即为要送出的错误信息。如果仅使用这一个参数，会按配置文件php.ini中所设置的位置处发送消息。

第二个参数 message_type为整数值：0表示送到操作系统的日志中；1则使用PHP的Mail()函数，发送信息到某E-mail处。

第四个参数extra_headers亦会用到；2则将错误信息送到TCP服务器中，此时第三个参数destination表示目的地IP及Port；3则将信息存到文件destination中。

如果以登入Oracle数据库出现问题的处理为例，该函数的使用如下所示：

if(!Ora_Logon($username, $password)){    
    error_log("Oracle数据库不可用!", 0);        //将错误消息写入到操作系统日志中  
}
if(!($foo=allocate_new_foo()){  
    error_log("出现大麻烦了!", 1, ". 111cn.net");   //发送到管理员邮箱中  
}
error_log("搞砸了!",2,"localhost:5000");     //发送到本机对应5000端口的服务器中
error_log("搞砸了!",3,"/usr/local/errors.log");  //发送到指定的文件中

2、 错误信息记录到操作系统的日志里

错误报告也可以被记录到操作系统日志里，但不同的操作系统之间的日志管理有点区别。在Linux上错误语句将送往syslog，而在Windows上错误将发送到事件日志里。如果你不熟悉syslog，起码要知道它是基于UNIX的日志工具，它提供了一个API来记录与系统和应用程序执行有关的消息。

Windows事件日志实际上与UNIX的syslog相同，这些日志通常可以通过事件查看器来查看。如果希望将错误报告写到操作系统的日志里，可以在配置文件中将error_log指令的值设置为syslog。

具体需要在php.ini中修改的配置指令如下所示：

1. error_reporting  =  E_ALL                   ;将会向PHP报告发生的每个错误  

2. display_errors = Off                        ;不显示 满足上条指令所定义规则的所有错误报告  

3. log_errors = On                             ;决定日志语句记录的位置  

4. log_errors_max_len = 1024                   ;设置每个日志项的最大长度  

5. error_log = syslog                          ;指定产生的错误报告写入操作系统的日志里 

除了一般的错误输出之外，PHP还允许向系统syslog中发送定制的消息。虽然通过前面介绍的error_log()函数，也可以向syslog中发送定制的消息，但在PHP中为这个特性提供了需要一起使用的4个专用函数。

分别介绍如下：

define_syslog_variables()

在使用openlog()、syslog及closelog()三个函数之前必须先调用该函数。因为在调用该函数时，它会根据现在的系统环境为下面三个函数初使用化一些必需的常量。

openlog()

打开一个和当前系统中日志器的连接，为向系统插入日志消息做好准备。并将提供的第一个字符串参数插入到每个日志消息中，该函数还需要指定两个将在日志上下文使用的参数，可以参考官方文档使用。

 syslog()

该函数向系统日志中发送一个定制消息。需要两个必选参数，第一个参数通过指定一个常量定制消息的优先级。例如LOG_WARNING表示一般的警告，LOG_EMERG表示严重地可以预示着系统崩溃的问题，一些其他的表示严重程度的常量可以参考官方文档使用。第二个参数则是向系统日志中发送的定制 消息，需要提供一个消息字符串，也可以是PHP引擎在运行时提供的错误字符串。

closelog()

该函数在向系统日志中发送完成定制消息以后调用，关闭由openlog()函数打开的日志连接。

如果在配置文件中，已经开启向syslog发送定制消息的指令，就可以使用前面介绍的四个函数发送一个警告消息到系统日志中，并通过系统中的syslog解析工具，查看和分析由PHP程序发送的定制消息，如下所示：

define_syslog_variables(); 

openlog("PHP5", LOG_PID , LOG_USER); 

syslog(LOG_WARNING, "警告报告向syslog中发送的演示， 警告时间：".date("Y/m/d H:i:s"));

closelog();

以Windows系统为例，通过右击"我的电脑"选择管理选项，然后到系统工具菜单中，选择事件查看器，再找到应用程序选项，就可以看到我们自己定制的警告消息了。上面这段代码将在系统的syslog文件中，生成类似下面的一条信息，是事件的一部分：

1. PHP5[3084], 警告报告向syslog中发送的演示， 警告时间：2009/03/26 04:09:11. 

使用指定的文件还是使用syslog记录错误日志，取决于你所在的Web服务器环境。如果你可以控制Web服务器，使用syslog是最理想的，因为你能利用syslog的解析工具来查看和分析日志。但如果你的网站在共享服务器的虚拟主机中运行，就只有使用单独的文本文件记录错误日志了。

error_log开启需要在apache中打开了，但是我们也可以在于php中来记录了在php中有一个error_log函数只要apache中的error_log = on我们就可以使用，具体的来看看。

做开发的经常碰到这种情况，在线下测试的挺好的程序，上传到线上（生产环境）就会出现奇奇怪怪的错误，比如出现个空白页面，也不知道是哪里出问题了，而线上又不允许调试，那该如何去解决这个问题呢？除了在仔细一遍遍的检查代码外，还可以通过开启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()这个函数的用法，以及一些需要注意的问题。

实例

<?php
$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文件，会发现文字是没有换行的，这给阅读带来很大的困难，需要改进下。经研究，使用如下代码，可以写入换行的信息。

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

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

知识扩充

下面补充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。

例子

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

<?php
$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 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

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

因为今天要做一个由数组构成的数据分类了，也就是不用数据库直接使用数组来存储栏目分类了，所以在验证时要以key作为ID，但是传值时我们要验证Key是否存了，所以用到了判断键值是否存功能，下面就来看一篇小编整理的php数组判断键值是否存在示例，具体如下。

PHP 检测数组是否存在某个键值 判断数组索引是否存在 array_key_exists();

bool array_key_exists ( mixed key, array search )

代码如下	复制代码
<?php /*   array_key_exists() 在给定的 key 存在于数组中时返回 TRUE。key 可以是任何能作为数组索引的值。   */   $search_array = array("first" => 1, "second" => 4); if (array_key_exists("first", $search_array)) {    echo "The 'first' element is in the array"; } ?>

网上说还有empty,isset也可以来验证key值是否存在

empty： 参数为0或为NULL时（如上面列子），empty均返回TRUE，详细情况可以参见empty官方手册
isset： 参数为NULL时，返回FALSE，0与NULL在PHP中是有区别的，isset(0)返回TRUE

代码如下

复制代码

<?php $a = array('a'=>1, 'b'=>0, 'c'=>NULL);   echo 'a test by empty: ' , empty($a['a']) ? 'not exist' : 'exist', PHP_EOL; echo 'a test by isset: ' , isset($a['a']) ? 'exist' : 'not exist', PHP_EOL; echo 'a test by array_key_exists: ' , array_key_exists('a', $a) ? 'exist' : 'not exist', PHP_EOL, PHP_EOL;   echo 'b test by empty: ' , empty($a['b']) ? 'not exist' : 'exist', PHP_EOL; echo 'b test by isset: ' , isset($a['b']) ? 'exist' : 'not exist', PHP_EOL; echo 'b test by array_key_exists: ' , array_key_exists('b', $a) ? 'exist' : 'not exist', PHP_EOL, PHP_EOL;   echo 'c test by empty: ' , empty($a['c']) ? 'not exist' : 'exist', PHP_EOL; echo 'c test by isset: ' , isset($a['c']) ? 'exist' : 'not exist', PHP_EOL; echo 'c test by array_key_exists: ' , array_key_exists('c', $a) ? 'exist' : 'not exist', PHP_EOL, PHP_EOL; 输出结果如下： ======================================================== a test by empty: exist a test by isset: exist a test by array_key_exists: exist   b test by empty: not exist b test by isset: exist b test by array_key_exists: exist   c test by empty: not exist c test by isset: not exist c test by array_key_exists: exist

三种方式的语法区别

empty： 参数为0或为NULL时（如上面列子），empty均返回TRUE，详细情况可以参见empty官方手册
isset： 参数为NULL时，返回FALSE，0与NULL在PHP中是有区别的，isset(0)返回TRUE
array_key_exists： 纯粹的判断数组键值对是否存在，无论值是多少

所以，从准确性的角度来看，array_key_exists是最准确的！

 
三种方式的性能比较

从网上拿到一组数据，参见这里或参考资料，如下所示：

For a small array:

array_key_exists: float(0.18357992172241)

empty: float(0.072798013687134)

isset: float(0.070242881774902)

For a relative big array:

array_key_exists: float(0.57489585876465)

empty: float(0.0068421363830566)

isset: float(0.0069410800933838)

可以看到在大数据情况下，empty和isset的性能比array_key_exists快了2个数量级，差别还是很大。如果频繁判断，还是需要优化。产生这么大性能差别的原因，个人猜测，可能是isset和empty作为php语法结构不是函数，php解释器做了优化，而array_key_exists作为函数，没有相关优化。具体原因，有待通过源码考究。

 
三种方式的使用建议

（鉴于empty与isset性能类似，但是isset准确性较高，这里就只比较isset与array_key_exists）

如果数组不可能出现值为NULL的情况，建议使用isset
如果数组中经常出现值为NULL的情况，建议使用array_key_exists
如果数组中可能出现值为NULL，但是较少的情况，建议结合isset与array_key_exists使用，如“if (isset($arr[‘key’]) || array_key_exists(‘key’, $arr)){/*do somthing*/}”。此方法兼顾了性能和准确性，但是代码变长了。

laravel-debugbar 调试工具的教程小编整理了几篇不错的教程，今天我们来看一篇Laravel 调试工具 laravel-debugbar 打印日志消息例子，希望文章对各位有帮助。

其实不用 Facade 方式更好用，因为使用 Facade 还要引入命名空间，那不得每个 debug 的地方都引入命名空间吗，这样显得不太好。

laravel-debugbar 提供了全局的函数，位于 /vendor/barryvdh/laravel-debugbar/src/helpers.php，已经在组件的 composer.json 中定义了自动加载，因此可以直接使用帮助函数，如打印 info 级别的日志信息：

debugbar()->info($data);

直接这样调用就好了。

看看函数定义：

if (!function_exists('debugbar')) {
    /**
     * Get the Debugbar instance
     *
     * @return \Barryvdh\Debugbar\LaravelDebugbar
     */
    function debugbar()
    {
        return app('debugbar');
    }
}

打印消息如图所示：

laravel-debugbar 是个很好的调试工具，主持 psr-3 规范对日志消息定义的几种级别，在开发中可以很好的利用这个工具，提高开发、排错的效率。