bugban/yii2

Bugban error & monitoring SDK — Yii2 extension that auto-captures exceptions.

v1.0.0 2026-07-15 15:34 UTC

Requires

• php: >=7.0
• bugban/php-sdk: *
• yiisoft/yii2: >=2.0

MIT

• exceptions
• monitoring
• yii
• yii2
• error-tracking
• bugban

Published on Packagist.org on 2026-07-15 15:41 UTC

README

Yii2 extension for the Bugban error & monitoring SDK. It auto-captures unhandled exceptions by swapping in a Bugban-aware errorHandler component and initializes the framework-agnostic bugban/php-sdk core for you.

Compatible with yiisoft/yii2 >=2.0 and PHP 7.0+.

Install

composer require bugban/yii2

Configure — web app (config/web.php)

Register the bootstrap and swap the errorHandler component:

return [
    // ...
    'bootstrap' => ['bugban'],
    'components' => [
        'bugban' => ['class' => \Bugban\Yii2\Bootstrap::class],
        'errorHandler' => ['class' => \Bugban\Yii2\WebErrorHandler::class],
    ],
    'params' => [
        'bugban' => [
            'api_key' => 'bb_xxx',
            'host' => 'https://bugban.online',
            'environment' => 'production',
        ],
    ],
];

Configure — console app (config/console.php)

return [
    // ...
    'bootstrap' => ['bugban'],
    'components' => [
        'bugban' => ['class' => \Bugban\Yii2\Bootstrap::class],
        'errorHandler' => ['class' => \Bugban\Yii2\ConsoleErrorHandler::class],
    ],
    'params' => [
        'bugban' => [
            'api_key' => 'bb_xxx',
            'host' => 'https://bugban.online',
            'environment' => 'production',
        ],
    ],
];

That's it — unhandled exceptions are now reported to Bugban automatically. The bugban component reads its config from params['bugban']; it no-ops if api_key is empty.

Manual capture

You can also report manually anywhere in your app:

use Bugban\Sdk\Bugban;

try {
    // ...
} catch (\Throwable $e) {
    Bugban::capture($e);
}

// Or a message:
Bugban::captureMessage('Something noteworthy happened', 'warning');

Configuration reference

Key	Type	Default
api_key	string	''
host	string	https://bugban.online
environment	string	production
release	string	null
enabled	bool	true
capture_requests	bool	false
sample_rate	float	1.0
redact	array	[]