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