Log4PHP 配置和使用

Log4PHP2.3.0使用解释

1. 什么是Log4PHP

Log4php它为apche组织维护项目，是Log4xx系列日志组件之一，log4j在JAVA中可算是大名鼎鼎的日志开发包。Log4PHP也作为一个单独的子项目存在，可以很方便的加载使用。

apache官方网站：http://logging.apache.org/log4php/

另外一个LOG4PHP的主站：http://www.vxr.it/log4php/

2. Log4PHP目录结构

从apache官网下载之后，解压得到的文件夹目录如下：

对于需要的LOG4PHP的主要核心代码在src/main/php下面，

3. Log4PHP的简单使用

3.1 建立Log4PHP的XML配置文件

 <?xml version="1.0" encoding="UTF-8"?>
 <configuration xmlns="http://logging.apache.org/log4php/">
     <!-- 标准控制台输出的appender -->
     <appender name="STDOUT" class="LoggerAppenderConsole">
         <param name="threshold" value="debug"/>
         <layout class="LoggerLayoutPattern" >
             <param name="ConversionPattern" value="[%date{Y-m-d H:i:s,u}] [%t] %-5p %l - %message%newline%ex"/>
         </layout>
     </appender>

     <!-- 记录所有ERROR日志的appender -->
     <appender name="ERROR-ALL" class="LoggerAppenderDailyFile">
         <layout class="LoggerLayoutPattern" >
             <param name="ConversionPattern" value="[%date{Y-m-d H:i:s,u}] [%t] %-5p %l - %message%newline%ex"/>
         </layout>
         <param name="file" value="log/php-error.log.%s" />
         <param name="threshold" value="error"/>
         <param name="append" value="true" />
         <param name="datePattern" value="Y-m-d" />
     </appender>

     <!-- 记录所有DEBUG日志的appender -->
     <appender name="DEBUG-ALL" class="LoggerAppenderDailyFile">
         <layout class="LoggerLayoutPattern" >
             <param name="ConversionPattern" value="[%date{Y-m-d H:i:s,u}] [%t] %-5p %l - %message%newline%ex"/>
         </layout>
         <param name="file" value="log/php-debug.log.%s" />
         <param name="threshold" value="debug"/>
         <param name="append" value="true" />
         <param name="datePattern" value="Y-m-d" />
     </appender>

     <!-- 记录所有INFO日志的appender -->
     <appender name="INFO-ALL" class="LoggerAppenderDailyFile">
         <layout class="LoggerLayoutPattern" >
             <param name="ConversionPattern" value="[%date{Y-m-d H:i:s,u}] [%t] %-5p %l - %message%newline%ex"/>
         </layout>
         <param name="file" value="log/php-info.log.%s" />
         <param name="threshold" value="info"/>
         <param name="append" value="true" />
         <param name="datePattern" value="Y-m-d" />
     </appender>

     <root>
         <level value="warn"/>
         <appender-ref ref="STDOUT"/>
         <appender-ref ref="DEBUG-ALL"/>
         <appender-ref ref="INFO-ALL"/>
         <appender-ref ref="ERROR-ALL"/>
     </root>
 </configuration>

3.2 简单PHP测试

 <?php
 　　require_once('log4php/Logger.php');
 　　Logger::configure('log4php.xml');
 　　$pay = Logger::getRootLogger();
 　　$pay->info('测试LOG4PHP');
 　　//$pay->warn("测试LOG4PHP");
 　　//$pay->debug("测试LOG4PHP");
 　　//$pay->error("测试LOG4PHP");
 　　//$pay->fatal("测试LOG4PHP");
 ?>

运行PHP文件即可，即：

info 、debug 不会产生文件

warn 生成两个文件：php-debug.log***  php-info.log***

errror fatal会产生三个文件：php-debug.log***  php-error.log***  php-info.log***

4. Log4PHP的配置文件解释

4.1 优先级

由低到高： debug、 info、warn、 error、 fatal， 日志的输出和你的等级设置相关，比如上面的配置文件，root 下的  level = debug 那么所有的等级都会出现日志,但是日志文件的数量是不等的

4.2 日志输出的目的地

（有很多种，数据库、文件等等）

LoggerAppenderConsole //以php://stdout为输出地
LoggerAppenderDailyFile //继承自LoggerAppenderFile, 以文件为输出地，每日输出一个文件
LoggerAppenderDb   //以数据库为输出地
LoggerAppenderEcho //在执行文件尾输出
LoggerAppenderFile //以文件为输出地
LoggerAppenderMail //以邮件为输出地
LoggerAppenderMailEvent //继承自LoggerAppenderMail, 以邮件为输出地, 为事件触发
LoggerAppenderNull //不输出任何信息
LoggerAppenderPhp //输出至PHP错误信息，将各类日志等级信息转化为php标准信息
LoggerAppenderRollingFile //继承自LoggerAppenderFile，以xxx.log.1, xxx.log.2的形式输出，
LoggerAppenderSocket //以socket方式输出
LoggerAppenderSyslog //以系统日志为目的地输出，使用php中的syslog()函数进行记录

4.3 输出的格式

日志输出的格式，LOG4PHP有5种输出方式

LoggerLayoutHtml//以html格式输出调试信息
LoggerLayoutSimple//简单的以 "等级信息 - 日志信息"的格式显示
LoggerLayoutTTCC//以"月/日/年 时间[进程] 等级信息 日志名称 - 调试信息"的格式来显示
LoggerPatternLayout//以模式表达式作为输出格式来显示（这个功能极为强悍，你可以随心所欲的来设置输出格式，在实例部分详细讲解）
LoggerXmlLayout//以xml的模式来输出

这样就可以通过建立多个配置文件，采用灵活管理日志目录，为每一个产品模块采用不同的配置。