README

此包为 symfony/monolog-bundle (>= 3.0) 添加了对额外字段的支撑。

目录

• 安装
• 配置
• 用法
• 版本控制
• 贡献
• 黑客攻击
• 许可证

安装

此包至少需要 Symfony 3.0。

您可以使用 composer 安装 monolog-extra-bundle

composer require chaplean/monolog-extra-bundle

然后添加到您的 AppKernel.php

new Chaplean\Bundle\MonologExtraBundle\ChapleanMonologExtraBundle(),

配置

可选地，如果您想添加全局额外字段。

services.yml

services:
    your_service_name:
        class: Chaplean\Bundle\MonologExtraBundle\Processor\ExtraFieldsProcessor
        arguments:
            $globalExtraFields:
                key : 'value'
                key2 : 'value2'
        tags:
            - { name: monolog.processor, handler: your_handler }

用法

如果您想使用记录器并发送额外字段，可以使用 LoggerExtra，它公开与默认记录器相同的函数。在上下文中添加一个键 'extra'，包含附加字段的列表。

$loggerExtra->error('message', ['extra' => ['key' => 'value']])

版本控制

monolog-extra-bundle 遵循 语义版本控制。简而言之，方案是 MAJOR.MINOR.PATCH，其中

1. MAJOR 在发生重大更改时增加，
2. MINOR 在以向后兼容的方式添加新功能时增加，
3. PATCH 在以向后兼容的方式修复错误时增加。

1.0.0 以下的版本被认为是实验性的，重大更改可能随时发生。

贡献

欢迎贡献！有许多贡献的方式，我们欣赏所有的贡献。以下是一些主要的贡献方式

• 错误报告：虽然我们努力提供高质量的软件，但错误可能发生，我们无法修复我们不知道的问题。所以即使您不确定或者只是想问一个问题，也请报告。无论如何，问题可能表明文档还可以进一步改进！
• 功能请求：您的用例没有被当前的 API 所覆盖？想要提出建议或添加某些内容？我们将很高兴看到这些内容，并开始讨论以尝试找到最佳解决方案。
• 拉取请求：想要贡献代码或文档？我们将非常高兴！如果您需要帮助开始，GitHub 有关于拉取请求的 文档。我们使用 "fork and pull 模型"，其中贡献者将更改推送到他们的个人分支，然后创建拉取请求到主仓库。请将您的拉取请求针对 master 分支。

提醒一下，所有贡献者都应遵守我们的 行为准则。

黑客攻击

当您在这个项目上黑客攻击时，您可能会发现以下命令很有用

# Install dependencies
composer install

# Run tests
bin/phpunit

许可证

monolog-extra-bundle 在 MIT 许可证的条款下分发。

有关详细信息，请参阅 LICENSE。