bughq/bughq-laravel

bughq error tracking - Laravel integration

v0.1.0 2026-07-14 14:26 UTC

Requires

• php: >=8.4
• bughq/bughq: ^0.1
• illuminate/support: ^11.0 || ^12.0
• monolog/monolog: ^3.0

Requires (Dev)

• orchestra/testbench: ^9.0 || ^10.0
• phpunit/phpunit: ^11.0

MIT

• laravel
• error-monitoring
• error-tracking
• bughq

Published on Packagist.org on 2026-07-14 14:29 UTC

README

Privacy-first error tracking for Laravel apps, backed by bughq/bughq and bughq.

Out of the box:

• Reported exceptions are captured through Laravel's exception handler (after your dontReport filtering), with route, request, and authenticated-user context attached.
• Failed queue jobs are captured with job name, queue, connection, and attempt count.
• SQL queries and log messages are recorded as breadcrumbs, so every event arrives with the trail that led to it.
• A bughq log channel turns Log::channel('bughq')->error(...) (or a stack channel) into bughq events.

Install

Requires PHP 8.4+ and Laravel 11 or 12.

composer require bughq/bughq-laravel

Until the packages are on Packagist, add the VCS repositories first:

composer config repositories.bughq-php vcs https://github.com/bughq/bughq-php
composer config repositories.bughq-laravel vcs https://github.com/bughq/bughq-laravel

The service provider and BugHQ facade are auto-discovered.

Configure

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

BUGHQ_PROJECT=acme-api
BUGHQ_KEY=pk_...
# or a single DSN:
# BUGHQ_DSN=https://[e-mail]/acme-api

environment defaults to the app environment; set BUGHQ_RELEASE to tag deploys. See config/bughq.php for breadcrumb/capture toggles, sample_rate, and ignore_exceptions.

Manual capture

use BugHQ\Laravel\Facades\BugHQ;

BugHQ::captureException($e, ['orderId' => $order->id]);
BugHQ::captureMessage('imports finished', 'info');
BugHQ::setTag('tenant', $tenant->slug);
BugHQ::setContext('order', ['id' => $order->id, 'total' => $order->total]);
BugHQ::addBreadcrumb(['category' => 'payment', 'message' => 'charge submitted']);

Log channel

// config/logging.php
'channels' => [
    'bughq' => ['driver' => 'bughq', 'level' => 'error'],

    // or fan out alongside your existing channel:
    'stack' => ['driver' => 'stack', 'channels' => ['single', 'bughq']],
],

Log records carrying an exception in context are captured with their full stack trace.

License

MIT