lzz199507/monolog-zh-doc

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

前言

搜了半天没有找到 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');

文档

• 使用指南
• 处理器、格式化器和加工程序
• 工具类
• 扩展 Monolog
• 日志记录的结构

第三方库

第三方的处理器、格式化器和加工程序的列表在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 而很多概念都有所调整。