README

使用 Doctrine2 ORM 存储在数据库中的 Symfony2 logger bundle

分支

• master
• develop

索引

• 安装
• 如何使用
• 历史
• 待办事项

安装

1. 使用 composer 下载 Kod3rLogBundle
2. 启用 Bundle
3. 在您的 config.yml 文件中配置该 Bundle

下载 Kod3rLogBundle

在项目根目录下执行以下命令

$ php composer require kod3r/log:dev-master

或者，如以下示例所示，将 kod3r/log Bundle 添加到您的 composer.json 文件中

"require": {
    ...
    "kod3r/log": "dev-master"
}

通过执行以下命令更新或安装 Bundle

$ php composer update kod3r/log

启用 Bundle

在 app/AppKernel.php 中注册 Bundle

// app/AppKernel.php
public function registerBundles()
{
    return array(
        ...
        new Kod3r\LogBundle\Kod3rLogBundle(),
    );
}

Bundle 配置

注册 Bundle 后，如果需要为所有生产环境设置通用配置，请转到 config.yml 文件。如果只想为生产环境设置配置，请将此配置添加到 config_prod.yml

通常，日志配置不会在配置文件中设置，如果已定义，则将 monolog 定义的选项与以下描述的选项混合。

# app/config/config.yml
monolog:
    handlers:
        backtrace:
            type: service
            level: warning # Mínimo nivel de log que se desea almacenar
            id: kod3r_log.logger_database # Servicio para inicializar el manejador de BD
            channels: ["!doctrine"] # Excluir el canal de doctrine

更新您的数据库以创建存储应用程序日志的 tb_system_log 表。

$ app/console doctrine:schema:update --force

如何使用

要在应用程序中包含日志，请在控制器的动作中使用以下示例。

use Symfony\Component\HttpFoundation\Request;

public function indexAction( Request $request ){
  // Obtener el manejador de logs
  $logger = $this->get( 'monolog.logger.backtrace' );

  // Obtener información de contexto a traves del servicio definido
  $context = $this->get('kod3r_log.logger_utils')->getContext($this, $request);

  // Definir parámetros extras del contexto
  $context = array(
    'custom': 'value'
  );

  // Agregar el log y el contexto
  $logger->warning( 'Este es un mensaje de WARNING!!!', $context );
}

历史

v1.0.2 (????-??-??)

• 添加通过 composer 安装的兼容性。
• 更新 composer.json 中的依赖项。

v1.0.1 (2015-10-01)

• 更改错误消息的格式化程序，现在使用 LineFormatter 而不是 JsonFormatter，并将扩展信息存储为 JSON 组成的字符串。
• 添加 LoggerUtils 类，以通过服务 $context = $this->get('kod3r_log.logger_utils')->getContext($this, $request); 方便地捕获上下文信息。

v1.0.0

• 初始版本

待办事项

• 定义 Bundle 的配置树。
• 允许开发人员定义他们想要的日志通道名称。