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

获取支持的 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 世界。