Apche日志系列(3)：定制日志
<p><FONT color=#000000> 有时候我们需要定制<a href="http://www.phpchina.com/javascript:;" onClick="javascript:tagshow(event, 'Apache');" target="_self"><u><strong>Apache</strong></u></a>默认<a href="http://www.phpchina.com/javascript:;" onClick="javascript:tagshow(event, '%C8%D5%D6%BE');" target="_self"><u><strong>日志</strong></u></a>的格式和内容，比如增加或减少日志所记录的信息、改变默认日志文件的格式等。本文介绍可以用日志记录的所有信息，以及如何设置Apache使其记录这些信息。 <BR><BR>一、定义日志格式(4月3日) <BR><BR> 很久以前，日志文件只有一种格式，这就是“公共格式”，许多人已经习惯于使用这种格式。随后出现了定制日志格式，而且看起来定制日志格式更很受欢迎，即使公共日志格式本身也重新用定制日志格式定义。本文介绍的就是如何随心所欲地定制日志文件的格式、如何让日志文件记录自己想要的信息。 <BR><BR> 定制日志文件的格式涉及到两个指令，即LogFormat指令和CustomLog指令，默认httpd.conf文件提供了关于这两个指令的几个示例。 <BR><BR> LogFormat指令定义格式并为格式指定一个名字，以后我们就可以直接引用这个名字。CustomLog指令设置日志文件，并指明日志文件所用的格式（通常通过格式的名字）。 <BR><BR> LogFormat指令的功能是定义日志格式并为它指定一个名字。例如，在默认的httpd.conf文件中，我们可以找到下面这行<a href="http://www.phpchina.com/javascript:;" onClick="javascript:tagshow(event, '%B4%FA%C2%EB');" target="_self"><u><strong>代码</strong></u></a>： <BR><BR><BR> LogFormat "%h %l %u %t \"%r\" %>s %b" common <BR><BR><BR> 该指令创建了一种名为“common”的日志格式，日志的格式在双引号包围的内容中指定。格式字符串中的每一个变量代表着一项特定的信息，这些信息按照格式串规定的次序写入到日志文件。 <BR><BR> Apache文档已经给出了所有可用于格式串的变量及其含义，下面是其译文： <BR><BR>---------------------------------------------------------------------- <BR><BR> %...a: 远程IP地址 <BR><BR> %...A: 本地IP地址 <BR><BR> %...B: 已发送的字节数，不包含HTTP头 <BR><BR> %...b: CLF格式的已发送字节数量，不包含HTTP头。 <BR><BR> 例如当没有发送数据时，写入‘-’而不是0。 <BR><BR> %...{FOOBAR}e: 环境变量FOOBAR的内容 <BR><BR> %...f: 文件名字 <BR><BR> %...h: 远程主机 <BR><BR> %...H 请求的协议 <BR><BR> %...{Foobar}i: Foobar的内容，发送给服务器的请求的标头行。 <BR><BR> %...l: 远程登录名字（来自identd，如提供的话） <BR><BR> %...m 请求的方法 <BR><BR> %...{Foobar}n: 来自另外一个模块的注解“Foobar”的内容 <BR><BR> %...{Foobar}o: Foobar的内容，应答的标头行 <BR><BR> %...p: 服务器响应请求时使用的端口 <BR><BR> %...P: 响应请求的子进程ID。 <BR><BR> %...q 查询字符串（如果存在查询字符串，则包含“?”后面的 <BR><BR> 部分；否则，它是一个空字符串。） <BR><BR> %...r: 请求的第一行 <BR><BR> %...s: 状态。对于进行内部重定向的请求，这是指*原来*请求 <BR><BR> 的状态。如果用%...>s，则是指后来的请求。 <BR><BR> %...t: 以公共日志时间格式表示的时间（或称为标准英文格式） <BR><BR> %...{format}t: 以指定格式format表示的时间 <BR><BR> %...T: 为响应请求而耗费的时间，以秒计 <BR><BR> %...u: 远程用户（来自auth；如果返回状态（%s）是401则可能是伪造的） <BR><BR> %...U: 用户所请求的URL路径 <BR><BR> %...v: 响应请求的服务器的ServerName <BR><BR> %...V: 依照UseCanonicalName设置得到的服务器名字 <BR><BR><BR>------------------------------------------------------------------ <BR><BR><BR> 在所有上面列出的变量中，“...”表示一个可选的条件。如果没有指定条件，则变量的值将以“-”取代。分析前面来自默认httpd.conf文件的LogFormat指令示例，可以看出它创建了一种名为“common”的日志格式，其中包括：远程主机，远程登录名字，远程用户，请求时间，请求的第一行代码，请求状态，以及发送的字节数。 <BR><BR> 有时候我们只想在日志中记录某些特定的、已定义的信息，这时就要用到“...”。如果在“%”和变量之间放入了一个或者多个HTTP状态代码，则只有当请求返回的状态代码属于指定的状态代码之一时，变量所代表的内容才会被记录。例如，如果我们想要记录的是网站的所有无效链接，那么可以使用： <BR><BR>---------------------------------------------------- <BR><BR> LogFormat %404{Referer}i BrokenLinks <BR><BR>--------------------------------------------------- <BR><BR><BR> 反之，如果我们想要记录那些状态代码不等于指定值的请求，只需加入一个“!”符号即可： <BR><BR> LogFormat %!200U SomethingWrong </FONT></p> <center><input type="image" onclick=copyToClipBoard() src="http://www.phpchina.com/images/phpcn_book_bu_tj.gif" border="0"></center>
