README

Monolog 将您的日志发送到文件、套接字、收件箱、数据库和各种网络服务。下面是完整的处理器列表。特殊的处理器允许您构建高级日志策略。

此库实现了 PSR-3 接口，您可以在自己的库中进行类型提示，以保持最大程度的互操作性。您也可以在应用程序中使用它，以确保您可以在将来使用另一个兼容的记录器。从 1.11.0 版本开始，Monolog 公共 API 也将接受 PSR-3 日志级别。内部上，Monolog 仍然使用自己的级别方案，因为它在 PSR-3 之前。

安装

使用以下命令安装最新版本

$ composer require monolog/monolog

基本用法

<?php

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

// create a log channel
$log = new Logger('name');
$log->pushHandler(new StreamHandler('path/to/your.log', Logger::WARNING));

// add records to the log
$log->warning('Foo');
$log->error('Bar');

文档

• 使用说明
• 处理器、格式化和处理器
• 实用类
• 扩展 Monolog
• 日志记录结构

从经济上支持 Monolog

通过 Tidelift 订阅 或通过 GitHub 赞助 获取支持的 Monolog 并帮助资助该项目。

Tidelift 为您构建应用程序时使用的开源依赖项提供商业支持和维护。节省时间，降低风险，并提高代码质量，同时资助您使用的确切依赖项的维护者。

第三方包

第三方处理器、格式化程序和处理器列在 维基百科 中。如果您发布了其中一个，也可以将其添加到那里。

关于

需求

• Monolog ^2.0 与 PHP 7.2 或更高版本兼容，使用 Monolog ^1.25 以支持 PHP 5.3+。

支持

目前 Monolog 1.x 的支持有限，并且只会进行重要的修复。您应该尽可能迁移到 Monolog 2，以利用所有最新的功能和修复。

提交错误和功能请求

错误和功能请求在 GitHub 上跟踪

框架集成

• 使用 PSR-3 的框架和库可以很容易地与 Monolog 一起使用，因为它实现了该接口。
• Symfony 默认包含 Monolog。
• Laravel 默认包含 Monolog。
• Lumen 默认包含 Monolog。
• PPI 默认包含 Monolog。
• CakePHP 可以通过 cakephp-monolog 插件使用 Monolog。
• Slim 可以通过 Slim-Monolog 日志写入器使用 Monolog。
• XOOPS 2.6 默认包含 Monolog。
• Aura.Web_Project 默认包含 Monolog。
• Nette 框架 可通过 contributte/monolog 扩展使用 Monolog。
• Proton 微型框架 默认包含 Monolog。
• FuelPHP 默认包含 Monolog。
• Equip 框架 默认包含 Monolog。
• Yii 2 可通过 yii2-monolog 或 yii2-psr-log-target 插件使用 Monolog。
• Hawkbit 微型框架 默认包含 Monolog。
• SilverStripe 4 默认包含 Monolog。

作者

Jordi Boggiano - [email protected] - http://twitter.com/seldaek
请参阅参与此项目的贡献者列表。

许可证

Monolog 采用 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。

致谢

此库深受 Python 的 Logbook 库的启发，尽管大多数概念都已调整以适应 PHP 世界。