您好,欢迎访问一九零五行业门户网

【PHP类库】Monolog

monolog是php的一个日志类库。相比于其他的日志类库,它有以下的特点:
功能强大。可以把日志发送到文件、socket、邮箱、数据库和各种web services。 遵循psr3的接口规范。可以很轻易的替换成其他遵循同一规范的日志类库。 良好的扩展性。通过handler、formatter和processor这几个接口,可以对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并不难,只需要实现monolog\handler\handlerinterface这个接口即可。
下面这个例子实现了把日志记录写到数据库里。我们不需要把接口里的方法全部实现一次,可以直接使用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
其它类似信息

推荐信息