[PHP 类库] Monolog - Logging for PHP 5.3+

Monolog是PHP的一个日志类库。相比于其余的日志类库，它有如下的特色：

• 功能强大。能够把日志发送到文件、socket、邮箱、数据库和各类web services。
• 遵循PSR3的接口规范。能够很轻易的替换成其余遵循同一规范的日志类库。
• 良好的扩展性。经过Handler、Formatter和Processor这几个接口，能够对Monolog类库进行各类扩展和自定义。

基本用法

安装最新版本：

composer require monolog/monolog

要求PHP版本为5.3以上。

php<?php

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

// 建立日志频道
$log = new Logger('name');
$log->pushHandler(new StreamHandler('path/to/your.log', Logger::WARNING));

// 添加日志记录
$log->addWarning('Foo');
$log->addError('Bar');

核心概念

每个Logger实例都包含一个频道名(channel)和handler的堆栈。当你添加一条记录时，记录会依次经过handler堆栈的处理。而每一个handler也能够决定是否把记录传递到下一个堆栈里的下一个handler。

经过handler，咱们能够实现一些复杂的日志操做。例如咱们把StreamHandler放在堆栈的最下面，那么全部的日志记录最终都会写到硬盘文件里。同时咱们把MailHandler放在堆栈的最上面，经过设置日志等级把错误日志经过邮件发送出去。Handler里有个$bubble属性，这个属性定义了handler是否拦截记录不让它流到下一个handler。因此若是咱们把MailHandler的$bubble参数设置为false，则出现错误日志时，日志会经过MailHandler发送出去，而不会通过StreamHandler写到硬盘上。

Logger能够建立多个，每一个均可以定义本身的频道名和handler堆栈。handler能够在多个Logger中共享。频道名会反映在日志里，方便咱们查看和过滤日志记录。

若是没有指定日志格式（Formatter），Handler会使用默认的Formatter。

日志的等级不能自定义，目前使用的是RFC 5424里定义的8个等级：debug、info、notice、warning、error、critical、alert和emergency。若是对日志记录有其余的需求，能够经过Processo对日志记录添加内容。

日志等级

• DEBUG (100): 详细的debug信息。
• INFO (200): 关键事件。
• NOTICE (250): 普通可是重要的事件。
• WARNING (300): 出现非错误的异常。
• ERROR (400): 运行时错误，可是不须要马上处理。
• CRITICA (500): 严重错误。
• EMERGENCY (600): 系统不可用。

用法详解

多个handler

php<?php

use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Handler\FirePHPHandler;

// 建立Logger实例
$logger = new Logger('my_logger');
// 添加handler
$logger->pushHandler(new StreamHandler(__DIR__.'/my_app.log', Logger::DEBUG));
$logger->pushHandler(new FirePHPHandler());

// 开始使用
$logger->addInfo('My logger is now ready');

第一步咱们先建立一个Logger实例，传入的是频道名，这个频道名能够用于区分多个Logger实例。

实例自己并不知道如何处理日志记录，它是经过handler进行处理的。handler能够设置多个，例如上面的例子设置了两个handler，能够对日志记录进行两种不一样方式的处理。

须要注意的是，因为handler是采用堆栈的方式保存，因此后面添加的handler位于栈顶，会首先被调用。

添加额外的数据

Monolog有两种方式对日志添加额外的信息。

使用上下文

第一个方法是使用$context参数，传入一个数组：

php<?php

$logger->addInfo('Adding a new user', array('username' => 'Seldaek'));

使用processor

第二个方法是使用processor。processor能够是任何可调用的方法，这些方法把日志记录做为参数，而后通过处理修改extra部分后返回。

php<?php

$logger->pushProcessor(function ($record) {
    $record['extra']['dummy'] = 'Hello world!';

    return $record;
});

Processor不必定要绑定在Logger实例上，也能够绑定到某个具体的handler上。使用handler实例的pushProcessor方法进行绑定。

频道的使用

使用频道名能够对日志进行分类，这在大型的应用上是颇有用的。经过频道名，能够很容易的对日志记录进行刷选。

例如咱们想在同一个日志文件里记录不一样模块的日志，咱们能够把相同的handler绑定到不一样的Logger实例上，这些实例使用不一样的频道名：

php<?php

use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Handler\FirePHPHandler;

// 建立handler
$stream = new StreamHandler(__DIR__.'/my_app.log', Logger::DEBUG);
$firephp = new FirePHPHandler();

// 建立应用的主要logger
$logger = new Logger('my_logger');
$logger->pushHandler($stream);
$logger->pushHandler($firephp);

// 经过不一样的频道名建立一个用于安全相关的logger
$securityLogger = new Logger('security');
$securityLogger->pushHandler($stream);
$securityLogger->pushHandler($firephp);

Handler

Monolog内置不少很实用的handler，它们几乎囊括了各类的使用场景，这里介绍一些使用的：

• StreamHandler：把记录写进PHP流，主要用于日志文件。
• SyslogHandler：把记录写进syslog。
• ErrorLogHandler：把记录写进PHP错误日志。
• NativeMailerHandler：使用PHP的mail()函数发送日志记录。
• SocketHandler：经过socket写日志。

php<?php

use Monolog\Logger;
use Monolog\Handler\SocketHandler;

// Create the logger
$logger = new Logger('my_logger');

// Create the handler
$handler = new SocketHandler('unix:///var/log/httpd_app_log.socket');
$handler->setPersistent(true);

// Now add the handler
$logger->pushHandler($handler, Logger::DEBUG);

// You can now use your logger
$logger->addInfo('My logger is now ready');

• AmqpHandler：把记录写进兼容amqp协议的服务。
• BrowserConsoleHandler：把日志记录写到浏览器的控制台。因为是使用浏览器的console对象，须要看浏览器是否支持。
• RedisHandler：把记录写进Redis。
• MongoDBHandler：把记录写进Mongo。
• ElasticSearchHandler：把记录写到ElasticSearch服务。
• BufferHandler：容许咱们把日志记录缓存起来一次性进行处理。

更多的Handler请看 https://github.com/Seldaek/monolog#handlers。

Formatter

一样的，这里介绍几个自带的Formatter：

• LineFormatter：把日志记录格式化成一行字符串。
• HtmlFormatter：把日志记录格式化成HTML表格，主要用于邮件。
• JsonFormatter：把日志记录编码成JSON格式。
• LogstashFormatter：把日志记录格式化成logstash的事件JSON格式。
• ElasticaFormatter：把日志记录格式化成ElasticSearch使用的数据格式。

更多的Formatter请看 https://github.com/Seldaek/monolog#formatters。

Processor

前面说过，Processor能够为日志记录添加额外的信息，Monolog也提供了一些很实用的processor：

• IntrospectionProcessor：增长当前脚本的文件名和类名等信息。
• WebProcessor：增长当前请求的URI、请求方法和访问IP等信息。
• MemoryUsageProcessor：增长当前内存使用状况信息。
• MemoryPeakUsageProcessor：增长内存使用高峰时的信息。

更多的Processor请看 https://github.com/Seldaek/monolog#processors。

扩展handler

Monolog内置了不少handler，可是并非全部场景都能覆盖到，有时须要本身去定制handler。写一个handler并不难，只须要实现Monolog\Handler\HandlerInterface这个接口便可。

下面这个例子实现了把日志记录写到数据库里。咱们不须要把接口里的方法所有实现一次，能够直接使用Monolog提供的抽象类AbstractProcessingHandler进行继承，实现里面的write方法便可。

php<?php

use Monolog\Logger;
use Monolog\Handler\AbstractProcessingHandler;

class PDOHandler extends AbstractProcessingHandler
{
    private $initialized = false;
    private $pdo;
    private $statement;

    public function __construct(PDO $pdo, $level = Logger::DEBUG, $bubble = true)
    {
        $this->pdo = $pdo;
        parent::__construct($level, $bubble);
    }

    protected function write(array $record)
    {
        if (!$this->initialized) {
            $this->initialize();
        }

        $this->statement->execute(array(
            'channel' => $record['channel'],
            'level' => $record['level'],
            'message' => $record['formatted'],
            'time' => $record['datetime']->format('U'),
        ));
    }

    private function initialize()
    {
        $this->pdo->exec(
            'CREATE TABLE IF NOT EXISTS monolog '
            .'(channel VARCHAR(255), level INTEGER, message LONGTEXT, time INTEGER UNSIGNED)'
        );
        $this->statement = $this->pdo->prepare(
            'INSERT INTO monolog (channel, level, message, time) VALUES (:channel, :level, :message, :time)'
        );
    }
}

而后咱们就可使用它了：

php<?php

$logger->pushHandler(new PDOHandler(new PDO('sqlite:logs.sqlite'));

// You can now use your logger
$logger->addInfo('My logger is now ready');

参考

https://github.com/Seldaek/monolog