log4php的配置及使用
log4php的使用
首先引入logger.php文件。log4php可以通过引入logger.php来完成自动加载的过程。文件位置如下:
日志记录器自身没有定义日志的输出目的地和格式,所以我们通常需要引入log4php后要先引入配置文件(下面会详细介绍)。日志记录器是一个组件,我们通过日志记录器来记录日志信息。引入配置文件后通过getLogger获得一个将日志记录器实体。然后可以通过打印方法打印出日志信息。打印方法通常包括info、warn、error、debug等。
include('Logger.php'); Logger::Configure(COMMON_PATH . 'Conf/log.php');//引入配置文件 $logger = Logger::getLogger("main"); //生成日志实例 $logger->info("This is an informational message."); //在规定好的输出目的地用规定好的输出格式显示信息消息
log4php配置
log4php配置文件支持 XML、PHP、Properties (INI)等格式。同样支持可编程配置,即通过函数来改变配置。
class MyConfigurator implements LoggerConfigurator { public function configure(LoggerHierarchy $hierarchy, $input = null) { // Create an appender which logs to file $appFile = new LoggerAppenderFile('foo'); $appFile->setFile('D:/Temp/log.txt'); $appFile->setAppend(true); $appFile->setThreshold('all'); $appFile->activateOptions(); // Use a different layout for the next appender $layout = new LoggerLayoutPattern(); $layout->setConversionPattern("%date %logger %msg%newline"); $layout->activateOptions(); // Create an appender which echoes log events, using a custom layout // and with the threshold set to INFO $appEcho = new LoggerAppenderEcho('bar'); $appEcho->setLayout($layout); $appEcho->setThreshold('info'); $appEcho->activateOptions(); // Add both appenders to the root logger $root = $hierarchy->getRootLogger(); $root->addAppender($appFile); $root->addAppender($appEcho); } }
Logger::Configure(COMMON_PATH . 'Conf/log.php');
项目中由这行代码引入配置。配置中一般包含以下内容:
1.日志信息的优先级;2.日志信息的输出目的地; 3.日志信息的输出格式。
一.log4php 日志信息优先级
日志信息的优先级从高到低有ERROR、WARN、INFO、DEBUG。
以下是常用四种等级的用法:
DEBUG Level指出细粒度信息事件对调试应用程序是非常有帮助的。
INFO level表明 消息在粗粒度级别上突出强调应用程序的运行过程。
WARN level表明会出现潜在错误的情形。
ERROR level指出虽然发生错误事件,但仍然不影响系统的继续运行。
程序只能显示比当前设置的等级优先级级更低的信息。例如当前程序设置level为DEBUG,那么就是说程序中所有信息都能显示出来。如果当前程序level为info,那么只有info,warn,error三中日志信息可以展示。
return array( 'rootLogger' => array( 'appenders' => array( 'myConsoleAppender', ), 'level' => 'DEBUG' ), )
二.输出地址配置
和优先级一样,输出地址同样可以在配置文件中作出配置,并且可以根据不同的日志类别设置不同的输出目的地。例:
'loginFileAppender' => [ 'class' => 'LoggerAppenderDailyFile', 'layout' => [ 'class' => 'LoggerLayoutPattern', 'params' => [ 'conversionPattern' => '%date [%logger] %message%newline', ], ], 'params' => [ 'file' => './log/login/login_%s.log', 'datePattern' => 'Y_m_d', ] ],
log4php支持12种输出目的地,分别为:
LoggerAppenderConsole 以php://stdout为输出目的地
LoggerAppenderFile 以文件为输出目的地
LoggerAppenderDailyFile 以文件为目的地,每日输出一个文件
LoggerAppenderDb 以数据库为输出目的地
LoggerAppenderEcho 在执行文件尾输出
LoggerAppenderMail 以邮件为输出地
LoggerAppenderMailEvent 以邮件为输出地, 为事件触发
LoggerAppenderNull 不输出任何信息
LoggerAppenderPhp LoggerAppenderPhp 输出至PHP错误信息,将各类日志等级信息转化为php标准信息
LoggerAppenderRollingFile 以xxx.log.1, xxx.log.2的形式输出
LoggerAppenderSocket 以socket方式输出
LoggerAppenderSyslog 以系统日志为目的地输出,使用php中的syslog()函数进行记录
代码中便是规定了以每日输出一个文件作为输出目的地,用来记录登录类型的日志信息。
三.日志文件输出格式
它作为输出目的地的一个属性存在,log4php上包含5种不同的输出方式,分别为:
LoggerLayoutHtml 以html格式输出调试信息
LoggerLayoutSimple 简单的以 "等级信息 - 日志信息"的格式显示
LoggerLayoutTTCC 以"月/日/年 时间[进程] 等级信息 日志名称 - 调试信息"的格式来显示
LoggerLayoutPattern 以模式表达式作为输出格式来显示(这个模式可以自定义输出格式)
LoggerXmlLayout//以xml的模式来输出
LoggerLayoutPattern 模式的一些格式参数
LoggerLayoutPattern为我们提供了自定义日志信息格式的方法,项目中也常常使用该模式来自定义日志信息。在实际使用中,我们通过配置conversionPattern参数来定义模式。而参数变量中通常使用一些log4php提供的转换说明符来配置。
例如:
'conversionPattern' => '%date [%logger] %message%newline'
格式为: yyyy-mm-ddThh:mm:ss+08:00.[日志类型].日志内容.换行。
常用的转换说明符有:
%logger(%lo,%c)请求日志的日志记录器的名称。
%data($d)时间。默认为ISO8601格式。可以通过%data{(格式)}改变格式。
%location(%l)调用者的位置信息
%message(%m %msg)日志的内容
%n(%newline)换行
%level(%p)当前日志事件的优先级
以上就是log4php的配置及使用的详细内容,更多请关注其它相关文章!