README

注意 这是 Monolog 3.x 的文档，如果您使用的是旧版本，请参阅 Monolog 2.x 或 Monolog 1.x 的文档

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

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

安装

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

$ composer require monolog/monolog

基本用法

<?php

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

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

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

文档

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

资助 Monolog

获取支持 Monolog 并通过 Tidelift 订阅 或通过 GitHub 赞助 支持Monolog。

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

第三方包

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

关于

要求

• Monolog ^3.0 与 PHP 8.1 或更高版本兼容。
• Monolog ^2.5 与 PHP 7.2 或更高版本兼容。
• Monolog ^1.25 与 PHP 5.3 至 8.1 兼容，但维护程度不高，并且不再接收 PHP 支持修复。

支持

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

提交错误和功能请求

错误和功能请求在 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 Framework 可以通过 contributte/monolog 或 orisai/nette-monolog 扩展与 Monolog 一起使用。
• Proton 微框架 默认内置 Monolog。
• FuelPHP 默认内置 Monolog。
• Equip 框架 默认内置 Monolog。
• Yii 2 可以通过 yii2-monolog 或 yii2-psr-log-target 插件与 Monolog 一起使用。
• Hawkbit 微框架 默认内置 Monolog。
• SilverStripe 4 默认内置 Monolog。
• Drupal 可以通过 monolog 模块与 Monolog 一起使用。
• Aimeos 电子商务框架 可以通过 ai-monolog 扩展与 Monolog 一起使用。
• Magento 默认内置 Monolog。
• Spiral 框架 默认内置 Monolog 桥接器。

作者

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

许可

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

致谢

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