/monolog-zh-doc

Monolog 的中文文档(欢迎帮忙翻译

MIT LicenseMIT

前言

搜了半天没有找到 Monolog 的中文文档,故自行翻译下吧。欢迎一起来提PR来帮忙翻译。

中英文对照:

  • channel: 通道
  • Processor: 加工程序
  • Handler: 处理器
  • Formatter: 格式化器
  • applications: 应用

原本的英文文档放在了 en文件夹下


Monolog - PHP日志库 Build Status

总下载量 最新稳定版本 引用状态

Monolog可以把你的日志发送到文件、套接字、邮箱、数据库以及各种各样的WEB服务上。参见下面完整的处理器列表。使用特定的处理器可以让你构建更高级的日志策略。

这个库实现了 PSR-3 接口,因此可以在你自己的库里面使用类型提示,这保持了一个最大化的互操作性。你也可以在你的应用中使用它,以保证以后总可以使用其他兼容的日志库。

从 1.11.0 版本起,Monolog 的公开 API 都将也接收 PSR-3 日志级别。而 Monolog 在内部依然会使用其自定义的日志级别,因为它早于 PSR-3.

安装

安装最新版本:

$ composer require monolog/monolog

基本用法

<?php

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

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

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

文档

第三方库

第三方的处理器、格式化器和加工程序的列表在wiki上. 如果你发布了一个,你也可以往上面添加一条。

关于

需求

  • Monolog 需要 PHP 7.0 或以上版本才能正常工作。至于 PHP 5.3 请使用 Monolog ^1.0.

提交 bug 和特性需求

Bug 和特性需求都是在 GitHub 上来管理的。

框架集成

作者

Jordi Boggiano - j.boggiano@seld.be - http://twitter.com/seldaek
参见 贡献者列表, 他们都参与了这个项目.

许可

Monolog 使用 MIT 许可证 - 更多详情参见 LICENSE 文件

鸣谢

这个库很大一部分程度上是被 Python 中的 Logbook 启发的,虽然为了适应 PHP 而很多概念都有所调整。