README

Symfony 扩展包，带有额外的处理器和记录器以记录请求/响应。

安装

使用 Symfony Flex 的应用程序

打开命令行，进入您的项目目录并执行

$ composer require hexanet/monolog-extra-bundle

不使用 Symfony Flex 的应用程序

步骤 1：下载扩展包

打开命令行，进入您的项目目录并执行以下命令以下载此扩展包的最新稳定版本

$ composer require hexanet/monolog-extra-bundle

此命令要求您已全局安装 Composer，请参阅 Composer 文档中的安装章节。

步骤 2：启用扩展包

然后，通过将其添加到项目 app/AppKernel.php 文件中注册的扩展包列表中来启用扩展包

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Hexanet\Common\MonologExtraBundle\HexanetMonologExtraBundle(),
        );
        // ...
    }

    // ...
}

使用方法

处理器

此扩展包提供几个处理器

• 用户
• 会话 ID
• UID
• 附加信息

用户

UserProcessor 将有关当前用户的数据添加到每个日志条目中。

hexanet_monolog_extra:
    processor:
        user: true

默认提供者返回

• 未登录时返回匿名
• 当前登录用户的用户名
• cli

您可以通过创建一个实现 Hexanet\Common\MonologExtraBundle\Provider\User\UserProviderInterface 的服务来创建自己的提供者。

hexanet_monolog_extra:
    provider:
        user: your_own_provider_service_id

会话 ID

将会话 ID 添加到每个日志条目中。

hexanet_monolog_extra:
    processor:
        session_id: true

您可以通过创建一个实现 Hexanet\Common\MonologExtraBundle\Provider\Session\SessionIdProviderInterface 的服务来创建自己的提供者。

hexanet_monolog_extra:
    provider:
        session_id: your_own_provider_service_id

UID

将请求的唯一标识符添加到每个日志条目中。

hexanet_monolog_extra:
    processor:
        uid: true

此扩展包提供了 2 个提供者

• UniqidProvider（默认）：使用 uniqid
• ApacheUniqueIdProvider：从环境变量中获取，需要 Apache 的 mod_unique_id

您可以通过创建一个实现 Hexanet\Common\MonologExtraBundle\Provider\Uid\UidProviderInterface 的服务来创建自己的提供者。

hexanet_monolog_extra:
    provider:
        uid: your_own_provider_service_id

附加信息

在每条日志条目中添加自定义数据。

hexanet_monolog_extra:
    processor:
        additions:
            type: symfony
            application: the best symfony application
            locale: "%locale%"
            environment: "%kernel.environment%"

日志记录器

请求时

使用请求数据创建日志条目。

响应时

使用响应数据创建日志条目。

控制台异常时

当控制台发生异常时创建日志条目。

将 UID 添加到响应中

将前一个处理器的 UID 添加到响应头中。

HTTP/1.1 302 Found
X-UID: 57c5f5e842b10

配置参考

配置参考，了解可用的配置选项。

致谢

由 Hexanet 开发。

许可证

MonologExtraBundle 采用 MIT 许可证。