bugban/symfony

Bugban error & monitoring SDK — Symfony bundle that auto-captures exceptions.

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

Requires

• php: >=7.1
• bugban/php-sdk: *
• symfony/config: >=3.4
• symfony/dependency-injection: >=3.4
• symfony/event-dispatcher: >=3.4
• symfony/http-kernel: >=3.4

MIT

• symfony
• exceptions
• monitoring
• error-tracking
• bugban

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

README

Symfony bundle for the Bugban error & monitoring SDK. It auto-captures unhandled exceptions via a kernel.exception listener and initializes the framework-agnostic bugban/php-sdk core for you.

Compatible with Symfony 3.4 → 7.x and PHP 7.1+.

Install

composer require bugban/symfony

Enable the bundle

Add it to config/bundles.php (Symfony Flex / 4+):

// config/bundles.php
return [
    // ...
    Bugban\Symfony\BugbanBundle::class => ['all' => true],
];

On Symfony 3.4 (AppKernel), add it to registerBundles():

public function registerBundles()
{
    $bundles = [
        // ...
        new Bugban\Symfony\BugbanBundle(),
    ];
    return $bundles;
}

Configure

Create config/packages/bugban.yaml:

bugban:
    api_key: '%env(BUGBAN_API_KEY)%'
    host: 'https://bugban.online'
    # environment: '%kernel.environment%'
    # release: '1.0.0'
    # enabled: true
    # capture_requests: false
    # sample_rate: 1.0

Then set your API key (e.g. in .env):

BUGBAN_API_KEY=bb_xxxxxxxxxxxxxxxx

That's it — unhandled exceptions are now reported to Bugban automatically.

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