README

简介

Rollbar-symfony 是一个与 symfony ~2.6|3.0 兼容的 symfony 扩展包。它将错误和一些日志报告到 "Rollbar"：http://www.rollbar.com

安装

步骤 1: 下载扩展包

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

$ composer require tekoway/symfony-rollbar

此命令需要您已全局安装 Composer，如 Composer 文档中的 安装章节 所述。

步骤 2: 启用扩展包

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

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Tekoway\Rollbar\TekowayRollbarBundle(),
        );

        // ...
    }

    // ...
}

步骤 3: 配置扩展包

在 app/config/config.yml 中启用扩展包的配置

tekoway_rollbar: 
    access_token: YOUR_ROLLBAR_ACCESS_TOKEN
    environment: ~
    enabled: ~
    error_levels: ~
    exceptions_ignore_list: ~

参数说明： environment：一个字符串值（将被发送到 Rollbar 的环境参数）。
enabled：一个布尔值（true|false）- 允许扩展包自动发送错误/异常到 rollbar（默认值为 false）。
error_levels：一个包含允许自动发送到 rollbar 的错误类型的数组（请参阅 预定义常量）。exceptions_ignore_list：一个包含在 rollbar 报告过程中要忽略的异常列表的数组（请参阅 Symfony 异常列表）。

完整的配置示例

    access_token: YOUR_ROLLBAR_ACCESS_TOKEN
    environment: production
    enabled: true
    error_levels: 
        - E_ERROR'
        - E_WARNING
        - E_PARSE
        - E_CORE_ERROR
        - E_CORE_WARNING
        - E_COMPILE_ERROR
        - E_COMPILE_WARNING
        - E_USER_ERROR
        - E_USER_WARNING
        - E_USER_NOTICE
        - E_STRICT
        - E_RECOVERABLE_ERROR
        - E_DEPRECATED
        - E_USER_DEPRECATED
        - E_ALL #include all above list
    exceptions_ignore_list: 
        - Symfony\Component\Security\Core\Exception\AccessDeniedException
        - Symfony/Component/Security/Core/Exception/AuthenticationException.php
        - #other exceptions

步骤 4: 使用

您可以使用 tekoway 日志记录器将日志写入 Rollbar

    $this->get('tekoway.logger.rollbar')->critical('critical message');
    $this->get('tekoway.logger.rollbar')->info('info message');
    $this->get('tekoway.logger.rollbar')->debug('debug message');
    $this->get('tekoway.logger.rollbar')->error('error message');
    $this->get('tekoway.logger.rollbar')->emergency('emergency message');
    $this->get('tekoway.logger.rollbar')->alert('alert message');
    $this->get('tekoway.logger.rollbar')->notice('notice message');
    $this->get('tekoway.logger.rollbar')->warning('warning message');

许可证

此扩展包受 MIT 许可证的约束。请参阅扩展包中的完整许可证。

关于

TekowayRollbarBundle 是 Tekoway 的一个倡议。请参阅贡献者列表。

报告问题或功能请求

问题和功能请求在 Github 问题跟踪器中进行跟踪。在报告错误时，最好在基于 Symfony 标准版构建的基本项目中重现它，以便扩展包的开发者可以通过克隆它并遵循一些步骤来重现问题。