前言
搜了半天没有找到 Monolog 的中文文档,故自行翻译下吧。欢迎一起来提PR来帮忙翻译。
中英文对照:
- channel: 通道
- Processor: 加工程序
- Handler: 处理器
- Formatter: 格式化器
- applications: 应用
原本的英文文档放在了 en文件夹下。
Monolog - PHP日志库
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 上来管理的。
框架集成
- 使用 PSR-3 的框架和库可以非常简单地集成 Monolog, 因为它实现了这个接口。
- Symfony2 开箱即用 Monolog.
- Silex 开箱即用 Monolog.
- Laravel 4 & 5 开箱即用 Monolog.
- Lumen 开箱即用 Monolog.
- PPI 开箱即用 Monolog.
- CakePHP 可以通过 cakephp-monolog 这个插件来使用 Monolog.
- Slim 可以通过 Slim-Monolog 这个日志适配器来使用 Monolog.
- XOOPS 2.6 开箱即用 Monolog.
- Aura.Web_Project 开箱即用 Monolog.
- Nette Framework 可以通过 Kdyby/Monolog 这个扩展来使用 Monolog.
- Proton Micro Framework 开箱即用 Monolog.
- FuelPHP 开箱即用 Monolog.
- Equip Framework 开箱即用 Monolog.
- Yii 2 可以通过 yii2-monolog 这个插件来使用 Monolog.
- Hawkbit Micro Framework 开箱即用 Monolog.
作者
Jordi Boggiano - j.boggiano@seld.be - http://twitter.com/seldaek
参见 贡献者列表, 他们都参与了这个项目.
许可
Monolog 使用 MIT 许可证 - 更多详情参见 LICENSE
文件
鸣谢
这个库很大一部分程度上是被 Python 中的 Logbook 启发的,虽然为了适应 PHP 而很多概念都有所调整。