PHP monolog

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


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




每一个Logger实例都包含一个频道名(channel)和handler的堆栈。当你添加一条记录时，记录会依次通过handler堆栈的处理。而每个handler也可以决定是否把记录传递到下一个堆栈里的下一个handler。handler()方法的返回值控制是否由上层handler继续处理，true表示不再继续处理。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。如果对日志记录有其他的需求，可以通过Processor对日志记录添加内容。


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


Monolog内置很多很实用的handler，它们几乎囊括了各种的使用场景，这里介绍一些使用的：
StreamHandler：把记录写进PHP流，主要用于日志文件。
SyslogHandler：把记录写进syslog。
ErrorLogHandler：把记录写进PHP错误日志。
NativeMailerHandler：使用PHP的mail()函数发送日志记录。
SocketHandler：通过socket写日志。
RedisHandler：把记录写进Redis。
MongoDBHandler：把记录写进Mongo。
ElasticSearchHandler：把记录写到ElasticSearch服务。


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


IntrospectionProcessor：增加当前脚本的文件名和类名等信息。
WebProcessor：增加当前请求的URI、请求方法和访问IP等信息。
MemoryUsageProcessor：增加当前内存使用情况信息。

MemoryPeakUsageProcessor：增加内存使用高峰时的信息。

Monolog 利用了PHP的单例模式，不过还是受限于PHP单例模式的局限性（PHP的解释运行机制使得每个PHP页面被解释执行后，所有的相关资源都会被回收，因此PHP单例模式只是针对单次页面级请求时出现多个应用场景并需要共享同一对象资源时是非常有意义）。