tekoway/symfony-rollbar

Symfony-Rollbar bundle

TekowayRollbarBundle

Introduction

Rollbar-symfony is a symfony bundle compatible with symfony ~2.6|3.0 It reports errors and some logs to "Rollbar":http://www.rollbar.com, _(*1)

Installation

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:, _(*2)

$ composer require tekoway/symfony-rollbar

This command requires you to have Composer installed globally, as explainedin the installation chapter of the Composer documentation., _(*3)

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:, _(*4)

<?php
// app/AppKernel.php

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

        // ...
    }

    // ...
}

Step 3: Configure the Bundle

Enable the bundle's configuration in app/config/config.yml:, _(*5)

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

Parameters explanation: environment: a string value (Environment parameter which will be send to Rollbar).
enabled: a bool value (true|false) - allow the bundle to send automatically errors/exceptions to rollbar (default value is false).
error_levels: an array that contains the error types allowed to send to rollbar automatically (see Predefined Constants ). exceptions_ignore_list: an array that contains the list of exceptions to be ignored in rollbar reporting process (see Symfony Exceptions List )., _(*6)

Full config example:, _(*7)

    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

Step 4: use

You can use the tekoway logger to write logs into Rollbar, _(*8)

    $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');

License

This bundle is under the MIT license. See the complete license in the bundle, _(*9)

About

TekowayRollbarBundle is a tekoway initiative. See also the list of contributors., _(*10)

Reporting an issue or a feature request

Issues and feature requests are tracked in the Github issue tracker. When reporting a bug, it may be a good idea to reproduce it in a basic project built using the Symfony Standard Edition to allow developers of the bundle to reproduce the issue by simply cloning it and following some steps., _(*11)