PHPackages                             bughq/bughq-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. bughq/bughq-laravel

ActiveLibrary

bughq/bughq-laravel
===================

bughq error tracking - Laravel integration

v0.1.0(1mo ago)2209MITPHPPHP >=8.4CI passing

Since Jul 14Pushed 1mo agoCompare

[ Source](https://github.com/bughq/bughq-laravel)[ Packagist](https://packagist.org/packages/bughq/bughq-laravel)[ Docs](https://bughq.org)[ RSS](/packages/bughq-bughq-laravel/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (5)Versions (2)Used By (0)

bughq for Laravel
=================

[](#bughq-for-laravel)

Privacy-first error tracking for Laravel apps, backed by [`bughq/bughq`](https://github.com/bughq/bughq-php) and [bughq](https://bughq.org).

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
-------

[](#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
---------

[](#configure)

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

```
BUGHQ_PROJECT=acme-api
BUGHQ_KEY=pk_...
# or a single DSN:
# BUGHQ_DSN=https://pk_...@bughq.org/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
--------------

[](#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
-----------

[](#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
-------

[](#license)

MIT

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance90

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

48d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/86ae8df6a3e7b071e4831eed7228eaa9690c44f19a69751bbb075aad609bbca0?d=identicon)[knightsky123](/maintainers/knightsky123)

---

Top Contributors

[![glennmichael123](https://avatars.githubusercontent.com/u/29087513?v=4)](https://github.com/glennmichael123 "glennmichael123 (5 commits)")

---

Tags

laravelerror-monitoringerror-trackingbughq

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bughq-bughq-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/bughq-bughq-laravel/health.svg)](https://phpackages.com/packages/bughq-bughq-laravel)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.7M3.5k](/packages/craftcms-cms)[illuminate/log

The Illuminate Log package.

6426.0M718](/packages/illuminate-log)[mateusjunges/laravel-kafka

A kafka driver for laravel

7313.9M26](/packages/mateusjunges-laravel-kafka)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45945.2k1](/packages/pressbooks-pressbooks)[psalm/plugin-laravel

Psalm plugin for Laravel

3365.5M359](/packages/psalm-plugin-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)