baibaratsky/yii2-rollbar

Rollbar for Yii2

Rollbar for Yii2

, _(*1)

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

Installation

The preferred way to install this extension is through composer., _(*3)

To install, either run $ php composer.phar require baibaratsky/yii2-rollbar:1.9.* or add "baibaratsky/yii2-rollbar": "1.9.*" to the require section of your composer.json file., _(*4)

If you want to use it with Yii prior to 2.0.13, you need yii2-rollbar of the version 1.6.*., _(*5)

Usage

1. Add the component configuration in your global main.php config file:, _(*6)

   'bootstrap' => ['rollbar'],
   'components' => [
    'rollbar' => [
        'class' => 'baibaratsky\yii\rollbar\Rollbar',
        'accessToken' => 'POST_SERVER_ITEM_ACCESS_TOKEN',
   
        // You can specify exceptions to be ignored by yii2-rollbar:
        // 'ignoreExceptions' => [
        //         ['yii\web\HttpException', 'statusCode' => [400, 404]],
        //         ['yii\web\HttpException', 'statusCode' => [403], 'message' => ['This action is forbidden']],
        // ],
    ],
   ],
   

2. Add the web error handler configuration in your web config file:, _(*7)

   'components' => [
    'errorHandler' => [
        'class' => 'baibaratsky\yii\rollbar\web\ErrorHandler',
   
        // You can include additional data in a payload:
        // 'payloadDataCallback' => function (\baibaratsky\yii\rollbar\web\ErrorHandler $errorHandler) {
        //     return [
        //         'exceptionCode' => $errorHandler->exception->getCode(),
        //         'rawRequestBody' => Yii::$app->request->getRawBody(),
        //     ];
        // },
    ],
   ],
   

3. Add the console error handler configuration in your console config file:, _(*8)

   'components' => [
    'errorHandler' => [
        'class' => 'baibaratsky\yii\rollbar\console\ErrorHandler',
    ],
   ],
   

Payload from your exceptions

If you want your exceptions to send some additional data to Rollbar, it is possible by implementing the WithPayload interface. ```php use baibaratsky\yii\rollbar\WithPayload;, _(*9)

class SomeException extends \Exception implements WithPayload { public function rollbarPayload() { return ['foo' => 'bar']; } } ```, _(*10)

Log Target

You may want to collect your logs produced by Yii::error(), Yii::info(), etc. in Rollbar. Put the following code in your config: ```php 'log' => [ 'targets' => [ [ 'class' => 'baibaratsky\yii\rollbar\log\Target', 'levels' => ['error', 'warning', 'info'], // Log levels you want to appear in Rollbar, _(*11)

         // It is highly recommended that you specify certain categories.
         // Otherwise, the exceptions and errors handled by the error handlers will be duplicated.
         'categories' => ['application'],
     ],
 ],

], ```, _(*12)

The log target also appends category and request_id parameters to the log messages. request_id is useful if you want to have a yii2-debug-like grouping., _(*13)