软件开发培训班 >> 编程开发 >> PHP


PHP error_log()将错误信息写入一个文件(定义和用法)

　　本文标签：error_log

在php程序编写中，养成写入log文件的编程习惯，是一个很好的编程习惯，程序员都应该学会这种编程思想，不要太浮躁 。前期编程的不严谨，往往会带来后期维护和调式的困难，付出的时间和精力将会更多 。
error_log() 是发送错误信息到某个地方的一个函数，在程序编程中比较常见，尤其是在程序调试阶段 。
本文将用实例讲解一下error_log()这个函数的用法，以及一些需要注意的问题 。

复制代码 代码如下:

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

上述是最常用的error_log()例子，它的作用是把一条信息写入errors.log这个文件里，这个文件如果不存在则自动创建 。在这个例子中，我们看到有一个参数“3”，注意这个数字“3”不能更改也不能去掉 。
下面列举一下使用error_log()这个函数的过程中可能出现的问题：
（1）程序报错提示：Warning: error_log() [function.error-log]: failed to open stream: Permission denied in ...on line ...
上述错误的出现，是因为文件没有写权限，开启该目录的文件写权限即可 。
（2）写入到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