README

Monolog - PHP 的日志记录

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

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

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

Better Stack 允许您集中、搜索和可视化您的日志。

安装

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

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

通过 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一起使用，因为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 - j.boggiano@seld.be - http://twitter.com/seldaek
有关参与此项目的贡献者列表，请参阅。

许可

Monolog 遵循 MIT 许可协议 - 请参阅 LICENSE 文件获取详细信息

致谢

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