在PHP语言中,内置了数量庞大的函数,每个函数的功能不尽相同。灵活的运用这些函数可以为我们带来许多功能的实现。下面我们就介绍一下PHP error_log()函数的相关功能。
PHP error_log()函数主要是用来写错误日志的函数,我们在多人开发,或者在比较复杂,并且没有单元测试的开发项目中,完全可以使用它来记录我们程序中的错误,特别是数据库查询语句执行的错误。
我们来大致了解一下PHP error_log()函数。我们看下手册的解释:
error_log
(PHP 3, PHP 4, PHP 5)
bool error_log ( string message [, int message_type [, string destination [, string extra_headers]]] )
发送一个错误信息到Web服务器的错误日志,一个TCP的端口或者是一个文件。
我们看PHP error_log()函数的参数,第一个参数message是消息内容,第二个参数type是消息类型,第三个参数是目标文件,第四个参数是其他的头信息。其实一般第四个参数都用不到,我们主要看前面三个参数,第二个参数是消息类型,包括0, 1, 2, 3等四种类型,0是默认的类型。四个类型的作用:
0
信息内容发送到PHP的系统日志记录,使用操作系统的自己的日志记录机制或一个文件,整个取决于php.ini中的配置选项error_log的内容。这是缺省选项。
1
把信息内容发送到一个邮件地址,第三个参数就是一个邮件地址,第四个参数是一个头信息发送邮件的,第二个类型使用mail()函数来发送邮件
2
消息通过PHP的调试服务器,远程的写入到某个PHP调试服务器上,当然,PHP在编译的时候--enable-debugger必须打开,另外,整个类型只是针对PHP 3有效
3
消息作为一个新行附加在一个目标文件中。其实对于我们来说,日志为了简便起见,一般直接使用类型3就比较合适了,把日志文件写到自己需要的文件中。
为了示例PHP error_log()函数的简单使用,我们个例子说明。假设我们数据库抽象类使用PEAR::DB类,现在我想在程序中记录我们的程序是否有执行错误。那么我们使用error_log()来记录我们那些SQL语句执行错误或者失败了,至少我们的PEAR::DB类提供了DB::isError()方法来获取某个执行结果对象是否有错误,那么我们就能够旁断是否执行某条SQL出现了错误,再来考虑是否记录日志,同时对象有个userinfo的属性,该属性记录了错误的SQL语句,那么我们可以构造这样一个函数:
1. function logError($object)
2. {
3. if(DB::isError($object))
4. {
5. error_log(date("[Y-m-d H:i:s]")
." -[".$_SERVER['REQUEST_URI'].
"] :".$object -> userinfo."\n",
3, "/tmp/php_sql_err.log");
6. return true;
7. }
8. return false;
9. }
PHP error_log()函数就是能够记录发现了错误SQL的地方,那么自动会把时间,当前页面,和错误的SQL语句信息记录到 /tmp/php_sql_err.log 文件当中,那么,当我们在调试程序的时候,发现数据提取不正确或者没有数据提取的时候,那么我们完全可以查看 /tmp/php_sql_err.log 文件来查看我们的错误页面和错误的SQL语句。
当然,我们必须在我们执行SQL查询的程序中去使用这个函数,比如我们执行一个编写一个提取新闻信息的函数:
1. function getNewsContent($news_id, $field="")
2. {
3. global $db;
4. $result = $db->getRow("SELECT
$field FROM news WHERE news_id = '$news_id'");
5. if (logError($result))
6. {
7. return false;
8. }
9. return $result;
10. }
我们在里面判断SQL是否错误,如果错误了则返回false,然后我们就可以查看日志一下,看我们的PHP error_log()函数运行是否如我们预期想象的一样。
我们执行: tail /tmp/php_sql_err.log,能看到类似于这样的信息:
[2006-01-12 11:44:34] -[/news_list.php?news_id=1] :SELECT FROM news WHERE news_id = '1' [nativecode=1064 ** You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version fo
r the right syntax to use near 'FROM news WHERE news_id = '1']
大致是因为我们select的时候,没有把需要提取的字段名写进去,那么我们就可以检查news_list.php文件,减产 getNewsContent()函数法向没有传递$field参数进去,导致SQL执行错误。所以error_log()函数就帮助检查我们的SQL写的是否正确,或者是参数没有传递正确,这样大大的减轻了开发负担,想但于了对我们的程序进行了单元测试。
当然,你也可以利用PHP error_log()函数做更多记录错误日志,方便PHP开发,这个全是由自己决定。
PHP error_log()函数主要是用来写错误日志的函数,我们在多人开发,或者在比较复杂,并且没有单元测试的开发项目中,完全可以使用它来记录我们程序中的错误,特别是数据库查询语句执行的错误。
我们来大致了解一下PHP error_log()函数。我们看下手册的解释:
error_log
(PHP 3, PHP 4, PHP 5)
bool error_log ( string message [, int message_type [, string destination [, string extra_headers]]] )
发送一个错误信息到Web服务器的错误日志,一个TCP的端口或者是一个文件。
我们看PHP error_log()函数的参数,第一个参数message是消息内容,第二个参数type是消息类型,第三个参数是目标文件,第四个参数是其他的头信息。其实一般第四个参数都用不到,我们主要看前面三个参数,第二个参数是消息类型,包括0, 1, 2, 3等四种类型,0是默认的类型。四个类型的作用:
0
信息内容发送到PHP的系统日志记录,使用操作系统的自己的日志记录机制或一个文件,整个取决于php.ini中的配置选项error_log的内容。这是缺省选项。
1
把信息内容发送到一个邮件地址,第三个参数就是一个邮件地址,第四个参数是一个头信息发送邮件的,第二个类型使用mail()函数来发送邮件
2
消息通过PHP的调试服务器,远程的写入到某个PHP调试服务器上,当然,PHP在编译的时候--enable-debugger必须打开,另外,整个类型只是针对PHP 3有效
3
消息作为一个新行附加在一个目标文件中。其实对于我们来说,日志为了简便起见,一般直接使用类型3就比较合适了,把日志文件写到自己需要的文件中。
为了示例PHP error_log()函数的简单使用,我们个例子说明。假设我们数据库抽象类使用PEAR::DB类,现在我想在程序中记录我们的程序是否有执行错误。那么我们使用error_log()来记录我们那些SQL语句执行错误或者失败了,至少我们的PEAR::DB类提供了DB::isError()方法来获取某个执行结果对象是否有错误,那么我们就能够旁断是否执行某条SQL出现了错误,再来考虑是否记录日志,同时对象有个userinfo的属性,该属性记录了错误的SQL语句,那么我们可以构造这样一个函数:
1. function logError($object)
2. {
3. if(DB::isError($object))
4. {
5. error_log(date("[Y-m-d H:i:s]")
." -[".$_SERVER['REQUEST_URI'].
"] :".$object -> userinfo."\n",
3, "/tmp/php_sql_err.log");
6. return true;
7. }
8. return false;
9. }
PHP error_log()函数就是能够记录发现了错误SQL的地方,那么自动会把时间,当前页面,和错误的SQL语句信息记录到 /tmp/php_sql_err.log 文件当中,那么,当我们在调试程序的时候,发现数据提取不正确或者没有数据提取的时候,那么我们完全可以查看 /tmp/php_sql_err.log 文件来查看我们的错误页面和错误的SQL语句。
当然,我们必须在我们执行SQL查询的程序中去使用这个函数,比如我们执行一个编写一个提取新闻信息的函数:
1. function getNewsContent($news_id, $field="")
2. {
3. global $db;
4. $result = $db->getRow("SELECT
$field FROM news WHERE news_id = '$news_id'");
5. if (logError($result))
6. {
7. return false;
8. }
9. return $result;
10. }
我们在里面判断SQL是否错误,如果错误了则返回false,然后我们就可以查看日志一下,看我们的PHP error_log()函数运行是否如我们预期想象的一样。
我们执行: tail /tmp/php_sql_err.log,能看到类似于这样的信息:
[2006-01-12 11:44:34] -[/news_list.php?news_id=1] :SELECT FROM news WHERE news_id = '1' [nativecode=1064 ** You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version fo
r the right syntax to use near 'FROM news WHERE news_id = '1']
大致是因为我们select的时候,没有把需要提取的字段名写进去,那么我们就可以检查news_list.php文件,减产 getNewsContent()函数法向没有传递$field参数进去,导致SQL执行错误。所以error_log()函数就帮助检查我们的SQL写的是否正确,或者是参数没有传递正确,这样大大的减轻了开发负担,想但于了对我们的程序进行了单元测试。
当然,你也可以利用PHP error_log()函数做更多记录错误日志,方便PHP开发,这个全是由自己决定。