(转)Log4php使用及配置指南
http://www.qinbin.me/log4php-use-and-configuration-guide/
一直是一个临时写的日志组件,不过现在随着功能的不断完善,程序的日志也做了规范,不过感觉现在的日志函数已经不能满足当前的需求了,所以考虑引入一个完善的日志组件,看了看Log4php感觉很不错。
Log4php是Log4xx系列日志组件之一,是Log4j迁移到php的版本,主要用来记录日志信息,支持多种输入目的地,包括:日志文件、日志回滚文件、数据库、日志服务器等等;同时,还支持多种输入格式。
使用实例:
1234567 require_once 'log4php/Logger.php'; Logger::configure('logger.properties'); $logger = Logger::getRootLogger(); //$logger->debug("Hello World!"); //$logger->info("Hello World!"); //$logger->warn("Hello World!"); //$logger->error("Hello World!");
appender.default = LoggerAppenderRollingFile log4php.appender.default.file = logger.log.php log4php.appender.default.layout = LoggerLayoutPattern log4php.appender.default.MaxFileSize = 1024 log4php.appender.default.MaxBackupIndex = 10 log4php.appender.default.layout.ConversionPattern = "%d{ISO8601} [%p] %c: %m (at %F line %L)%n"log4php.rootLogger = DEBUG, default
配置项说明:
Log4php由三个重要的组件构成:
日志信息的优先级;
日志信息的输出目的地;
日志信息的输出格式。
日志信息的优先级从高到低有ERROR、WARN、INFO、DEBUG,分别用来指定这条日志信息的重要程度;日志信息的输出目的地指定了日志将附加到执行文件尾还是文件中;而输出格式则控制了日志信息的显示内容。
1. 日志的优先级。
日志信息有四种分类(常用),可以通过在在配置文件中设置优先级来将代码中出现的调试信息显示或隐藏,举例来讲,当我把日志等级调整至WARN级时,那么程序中所出现的ERROR信息(通过$log->error(“error message here!”))及WARN等级的信息可以记录出来,而程序中所有使用INFO与DEBUG级的信息都将不显示,它由
“log4php.rootLogger=DEBUG, A1″中rootLogger的第一个参数定义,这一句的意思是将调试等级定义为DEBUG级,也就是说程序中所有的ERROR, WARN,INFO, DEBUG信息都可以显示出来, 如果将等级设置为INFO, 那么只能有ERROR, WARN, INFO这三种信息可显示。
以下是常用四种等级的用法:
DEBUG Level指出细粒度信息事件对调试应用程序是非常有帮助的。
INFO level表明 消息在粗粒度级别上突出强调应用程序的运行过程。
WARN level表明会出现潜在错误的情形。
ERROR level指出虽然发生错误事件,但仍然不影响系统的继续运行。
FATAL level指出每个严重的错误事件将会导致应用程序的退出。
2. 日志信息的输出目的地。、
在log4php中输出目的地支持12种,分别为:
<?php 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()函数进行记录 ?>
在配置文件中表现为”log4php.rootLogger=DEBUG, default” 从第二个参数起的别名,具体目的地的设置方式由:
12 log4php.appender.default=LoggerAppenderEcho log4php.appender.default.layout=LoggerLayoutHtml
来实现,每种输出目的地都有不同的设置参数,根据实际需要,输出的目的地可有多项,表现如下:
log4php.rootLogger=DEBUG, default, qinbin1, qinbin2, ….
其中default, qinbin1, qinbin2代表不同的输出目的地。
3. 日志文件输出格式。它作为输出目的地的一个属性存在,log4php上包含5种不同的输出方式,分别为:
LoggerLayoutHtml//以html格式输出调试信息
LoggerLayoutSimple//简单的以 "等级信息 - 日志信息"的格式显示
LoggerLayoutTTCC//以"月/日/年 时间[进程] 等级信息 日志名称 - 调试信息"的格式来显示
LoggerPatternLayout//以模式表达式作为输出格式来显示(这个功能极为强悍,你可以随心所欲的来设置输出格式,在实例部分详细讲解)
LoggerXmlLayout//以xml的模式来输出