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);
    }
}

log4php 官方文档:http://logging.apache.org/log4php/

        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）当前日志事件的优先级

关于转换说明符的完整说明：http://logging.apache.org/log4php/docs/layouts/pattern.html