baibaratsky/yii-rollbar

Rollbar Yii Extension

Rollbar Yii Component

, _(*1)

Rollbar Yii Component is the way to integrate Rollbar service with your Yii 1.* application. For Yii2 use yii2-rollbar., _(*2)

The code of this project has been forked from Ratchetio Component., _(*3)

Installation

1. The preferred way to install this component is through composer., _(*4)

   To install, either run, _(*5)

   $ php composer.phar require baibaratsky/yii-rollbar:2.3.*
   

   or add, _(*6)

   "baibaratsky/yii-rollbar": "2.3.*"
   

   to the require section of your composer.json file., _(*7)

2. Add rollbar component to the main.php config:, _(*8)

   // ...
   'components' => array(
       // ...
       'rollbar' => array(
           'class' => 'application.vendor.baibaratsky.yii-rollbar.RollbarComponent', // adjust path if needed
           'access_token' => 'your_serverside_rollbar_token',
       ),
   ),
   

3. Adjust main.php config to preload the component:, _(*9)

   'preload' => array('log', 'rollbar'),
   

4. Set RollbarErrorHandler as error handler:, _(*10)

   'components' => array(
       // ...
       'errorHandler' => array(
           'class' => 'application.vendor.baibaratsky.yii-rollbar.RollbarErrorHandler',
           // ...
       ),
   ),
   

   You can also pass some additional rollbar options in the component config, refer to the Rollbar documentation for all available options., _(*11)

   A good idea is to specify environment as:, _(*12)

   'environment' => isset($_SERVER['HTTP_HOST']) ? $_SERVER['HTTP_HOST'] : 'cli_' . php_uname('n'),
   

   You can specify alias of your project root directory for linking stack traces (application by default):, _(*13)

   'root' => 'root',
   

Rollbar Log Route

You may want to collect your logs produced by Yii::log() in Rollbar. Put the following code in your config and enjoy:, _(*14)

'components' => array(
    // ...
    'log' => array(
        // ...
        'routes' => array(
            array(
                'class' => 'application.vendor.baibaratsky.yii-rollbar.RollbarLogRoute',
                'levels' => 'error, warning, info',

                // You may specify the name of the Rollbar Yii Component ('rollbar' by default)
                'rollbarComponentName' => 'rollbar',
            ),
        ),
    ),
),