我的laravel框架版本是5.2,monlog配置是自定义的。
参考laravel学院:
Laravel目前支持四种日志处理器:
- single —— 将日志记录到单个文件中。该日志处理器对应Monolog的
StreamHandler
。 - daily —— 以日期为单位将日志进行归档,每天创建一个新的日志文件记录日志。该日志处理器 对应Monolog的
RotatingFileHandler
。 - syslog —— 将日志记录到syslog中。该日志处理器 对应Monolog的
SyslogHandler
。 - errorlog —— 将日志记录到PHP的error_log中。该日志处理器 对应Monolog的
ErrorLogHandler
。
项目实际日志处理器通过config/app.php
中的log
配置项决定,默认配置值为single
。这里我们使用默认值,不做修改:
'log' => 'single',
当然如果这四种方式满足不了你的需求,还可以使用configureMonologUsing
方法完全控制Monolog的日志处理器:
$app->configureMonologUsing(function($monolog) { $monolog->pushHandler(...); });
项目配置如下:注:必须将上述这段代码置于
bootstrap/app.php
文件返回$app
之前处才能生效。
在项目所在目录下bootstrap/app.php文件中添加:
$app->configureMonologUsing(function(Monolog\Logger $monolog) { $filename = storage_path('/logs/laravel-' . php_sapi_name() . '.log'); $handler = new Monolog\Handler\RotatingFileHandler($filename,
0, \Monolog\Logger::DEBUG, true, 0664); $handler->setFormatter(new \Monolog\Formatter\LineFormatter(null, null,
true, true)); $monolog->pushHandler($handler); });
其中有些点需要了解:
核心概念
每一个 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对日志记录添加内容。
实例本身并不知道如何处理日志记录,它是通过handler进行处理的。handler可以设置多个,例如上面的例子设置了两个
handler,可以对日志记录进行两种不同方式的处理。
需要注意的是,由于handler是采用堆栈的方式保存,所以后面添加的handler位于栈顶,会首先被调用。
Handler
Monolog内置很多很实用的handler,它们几乎囊括了各种的使用场景,这里介绍一些使用的:
StreamHandler
:把记录写进PHP流,主要用于日志文件。SyslogHandler
:把记录写进syslog。ErrorLogHandler
:把记录写进PHP错误日志。NativeMailerHandler
:使用PHP的 mail() 函数发送日志记录。SocketHandler
:通过socket写日志。
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
这个接口即可。