如何记录PHP错误日志

PHP中文网 • 2025年2月24日 21:36:48 • 编程技术 • 阅读 2

记录PHP错误日志的方法：首先设置PHP的配置文件；然后将使用指定的文件记录错误报告日志；最后错误信息记录到操作系统的日志里。

记录PHP错误日志的方法：

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

如果使用自己指定的文件记录错误日志，一定要确保将这个文件存放在文档根目录之外，以减少遭到攻击的可能。

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

立即学习“PHP免费学习笔记（深入）”；

相关学习推荐：php编程（视频）

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

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

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

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

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

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

PHP 的配置文件按上面的方式设置完成以后，并重新启动Web服务器。这样，在执行PHP的任何脚本文件时，所产生的所有错误报告都不会在浏览器中显示，而会记录在自己指定的错误日志/usr/local/error.log中。此外，不仅可以记录满足error_reporting所定义规则的所有错误，而且还可以使用PHP中的error_log()函数，送出一个用户自定义的错误信息。

该函数的原型如下所示：

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数据库出现问题的处理为例，该函数的使用如下所示：

登录后复制

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

错误报告也可以被记录到操作系统日志里，但不同的操作系统之间的日志管理有点区别。在Linux上错误语句将送往syslog，而在Windows上错误将发送到事件日志里。如果你不熟悉syslog，起码要知道它是基于UNIX的日志工具，它提供了一个API来记录与系统和应用程序执行有关的消息。 Windows事件日志实际上与UNIX的syslog相同，这些日志通常可以通过事件查看器来查看。如果希望将错误报告写到操作系统的日志里，可以在配置文件中将error_log指令的值设置为syslog。

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

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

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

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

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

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();  ?>

登录后复制