资讯专栏INFORMATION COLUMN

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

Gilbertat / 1227人阅读

摘要:当你添加一条记录时,记录会依次通过堆栈的处理。而每个也可以决定是否把记录传递到下一个堆栈里的下一个。同时我们把放在堆栈的最上面,通过设置日志等级把错误日志通过邮件发送出去。可以创建多个,每个都可以定义自己的频道名和堆栈。

Monolog是PHP的一个日志类库。相比于其他的日志类库,它有以下的特点:

功能强大。可以把日志发送到文件、socket、邮箱、数据库和各种web services。

遵循PSR3的接口规范。可以很轻易的替换成其他遵循同一规范的日志类库。

良好的扩展性。通过HandlerFormatterProcessor这几个接口,可以对Monolog类库进行各种扩展和自定义。

基本用法

安装最新版本:

composer require monolog/monolog

要求PHP版本为5.3以上。

phppushHandler(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
phppushHandler(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参数,传入一个数组:

phpaddInfo("Adding a new user", array("username" => "Seldaek"));
使用processor

第二个方法是使用processor。processor可以是任何可调用的方法,这些方法把日志记录作为参数,然后经过处理修改extra部分后返回。

phppushProcessor(function ($record) {
    $record["extra"]["dummy"] = "Hello world!";

    return $record;
});

Processor不一定要绑定在Logger实例上,也可以绑定到某个具体的handler上。使用handler实例的pushProcessor方法进行绑定。

频道的使用

使用频道名可以对日志进行分类,这在大型的应用上是很有用的。通过频道名,可以很容易的对日志记录进行刷选。

例如我们想在同一个日志文件里记录不同模块的日志,我们可以把相同的handler绑定到不同的Logger实例上,这些实例使用不同的频道名:

phppushHandler($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写日志。

phpsetPersistent(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并不难,只需要实现MonologHandlerHandlerInterface这个接口即可。

下面这个例子实现了把日志记录写到数据库里。我们不需要把接口里的方法全部实现一次,可以直接使用Monolog提供的抽象类AbstractProcessingHandler进行继承,实现里面的write方法即可。

phppdo = $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)"
        );
    }
}

然后我们就可以使用它了:

phppushHandler(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

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/30255.html

相关文章

  • composer

    摘要:自动加载为了实现类的随取随用,类的命名空间定义建议遵从一定的规则。这种规则可以是某一项目组约定的。不过为了使得类库统一,项目指定了一种命名空间的规范,被一些流行项目采用。用来指定在软件包级别上区别。注意默认类库是使用规范自动加载的。 简介 composer是一个php中管理依赖的工具。它使你可以在项目中声明用到的包/库,之后它会自动安装相关包。 Composer is not a ...

    Miyang 评论0 收藏0
  • php-composer的安装与使用方法(简化版)

    摘要:中文网系统要求运行需要以上版本。注中的路径为相对于的路径这个时候,你就可以调用你自己编写的函数库或者类库了注本文内容参考了中文网,后续还会更新其它的实用功能 1.简介 Composer 是 PHP 的一个依赖管理工具。它允许你申明项目所依赖的代码库,它会在你的项目中为你安装他们。《Composer 中文网》 2.系统要求 运行 Composer 需要 PHP 5.3.2+ 以上版本。C...

    mikasa 评论0 收藏0
  • Composer管理PHP依赖关系

    摘要:然而各自为政的打包方式依赖关系的处理,导致了很难将两个开源项目集成到一起。虽然有这种官方支持的包管理工具,但是依然没有很好的统一的依赖关系管理的办法。项目编译和打包依赖关系的解决都可以很轻松的实现。 简介 现在软件规模越来越大,PHP项目的开发模式和许多年前已经有了很大变化。记得初学PHP那会儿,boblog是一个很好的例子,几乎可以代表PHP项目的开发模式。当时PHP 5.x以上的版...

    Mertens 评论0 收藏0
  • Composer

    摘要:背景是的依赖管理工具,它涉及和,它并不是包管理器。将这样为你解决问题你有一个项目依赖于若干个库。其中一些库依赖于其他库。会找出哪个版本的包需要安装,并安装它们将它们下载到你的项目中。上述条命令的作用依次是下载安装脚本到当前目录。 composer背景 Composer是PHP的依赖管理工具,它涉及 packages 和 libraries,它并不是包管理器。它受到npm和bundler...

    zoomdong 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<