bugban/laravel

Bugban SDK — Laravel integration: automatic exception, request, auth & session capture.

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

Requires

• php: >=7.1
• bugban/php-sdk: *
• illuminate/support: >=5.5

MIT

• monitoring
• laravel
• error-tracking
• bugban

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

README

Automatic exception, request, auth-user & session capture for Laravel (5.5 → 12), on top of the framework-agnostic bugban/php-sdk core.

Install

composer require bugban/laravel

The service provider is auto-discovered. Optionally publish the config:

php artisan vendor:publish --tag=bugban-config

Configure — .env

BUGBAN_API_KEY=bb_xxxxxxxx
BUGBAN_HOST=https://bugban.online
BUGBAN_CAPTURE_REQUESTS=true      # optional: per-request performance logs

That's it. Every exception Laravel reports is sent to Bugban together with the authenticated user, session id and request. No code changes required.

Manual capture

try {
    // ...
} catch (\Throwable $e) {
    \Bugban\Sdk\Bugban::capture($e, ['order_id' => 123]);
}

How it works

• Hooks Laravel's MessageLogged event and forwards any logged exception (level error+).
• Resolves rich context (auth user, session, request) lazily via the core context_resolver.
• When BUGBAN_CAPTURE_REQUESTS=true, pushes request timing to /api/ingest/requests via a terminable middleware added to the web and api groups.

PHP 7.1 → 8.4 compatible.