pinfirestudios/yii2-bugsnag

Yii2 log target and ErrorHandler for BugSnag

1.0.5 2018-01-30 05:56 UTC

Requires

• bugsnag/bugsnag: 2.*
• yiisoft/yii2: ^2.0

Suggests

• bower-asset/bugsnag: Needed to enable Bugsnag JS logging. See README.md for installation instructions.

MIT

• Justin Cherniak

• logging
• errors

README

To use, configure as such:

$config = [
    'components' => [
        'errorHandler' => [
            'class' => 'pinfirestudios\yii2bugsnag\BugsnagWebErrorHandler' // For your web configuration
            'class' => 'pinfirestudios\yii2bugsnag\BugsnagConsoleErrorHandler' // For your console configuration
        ],
        'bugsnag' => [
            'class' => 'pinfirestudios\yii2bugsnag\BugsnagComponent', // Or your override of such
            'bugsnag_api_key' => 'YOUR API KEY',
            'notifyReleaseStages' => ['staging', 'production'],
        ],
        'log' => [
            'traceLevel' => 8,
            'targets' => [
                [
                    'class' => 'pinfirestudios\yii2bugsnag\BugsnagLogTarget',
                    'levels' => ['error', 'warning', 'info', 'trace'],
                    'logVars' => [],
                ]
            ],
        ],
    ],
];

If you would like to use Bugsnag's javascript on your site, you'll need to install bower-asset/bugsnag:

1. Add the following to your project's composer.json

   "repositories": [ { "type": "composer", "url": "https://asset-packagist.org" } ]

2. Require bower-asset/bugsnag

   composer require bower-asset/bugsnag

3. Once you have it installed, simply depend on BugsnagAsset in your AppAsset. This will automatically register Bugsnag's javascript to the page. Default version is 3.

   class AppAsset extends AssetBundle { public $depends = [ 'pinfirestudios\yii2bugsnag\BugsnagAsset', ]; }

If you need to use version 2 of Bugsnag's javascript, you can specify the version in your configuration. See Customizing Asset Bundles.