PHP错误日志

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

使 用指定的文件记录错误报告日志使用指定的文件记录错误报告日志使用指定的文件记录错误报告日志 若是使用本身指定的文件记录错误日志，必定要确保将这个文 件存放在文档根目录以外，以减小遭到攻击的可能。而且该文件必定要让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 = /usr/local/error.log                ;指定产生的 错误报告写入的日志文件位置  

 

PHP 的配置文件按上面的方式设置完成之后，并从新启动Web服务器。这样，在执行PHP的任何脚本文件时，所产生的全部错误报告都不会在浏览器中显示，而会记 录在本身指定的错误日志/usr/local/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数据库出现问题的处理为例，该函数的使用以下所示： 

1. <?php      

2.     if(!Ora_Logon($username, $password)){     

 3.         error_log("Oracle数据库不可用!", 0);        //将错误消息写入到操做系统日志中   

4.     }   

5.     if(!($foo=allocate_new_foo()){   

6.         error_log("出现大麻烦了!", 1, ". mydomain.com");   //发送到管理员邮箱中   

7.     }  

8.     error_log("搞砸了!",   2,   "localhost:5000");     //发送到本机对应5000端口的服务器中   

9.     error_log("搞砸了!",   3,   "/usr/local/errors.log");  //发送到指定的文件中   

10. ?>  

二、 错误信息记录到操做系统的日志里

错 误信息记录到操做系统的日志里错误信息记录到操做系统的日志里错误信息记录到操做系统的日志里 错误报告也能够被记录到操做系统日志里，但不一样的操做系统 之间的日志管理有点区别。在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程序发送的定制消息，以下所示： 

1.  

2.     define_syslog_variables();   

3.     openlog("PHP5", LOG_PID , LOG_USER);   

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

5.     closelog();   

6. ?> 

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

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

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