PHPackages                             debugd/debugd-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. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. debugd/debugd-laravel

ActiveLibrary[Debugging &amp; Profiling](/categories/debugging)

debugd/debugd-laravel
=====================

Zero-instrumentation request tracing for Laravel — passive collector for the debugd server.

v0.3.1(1mo ago)02↓85.7%MITPHPPHP ^8.2

Since Jun 5Pushed 1mo agoCompare

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

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

debugd for Laravel
==================

[](#debugd-for-laravel)

[![Packagist Version](https://camo.githubusercontent.com/4e9a15e3cc727caab06951244e987b96945096538a6b60c9e2c7caca7f4ce052/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6465627567642f6465627567642d6c61726176656c)](https://packagist.org/packages/debugd/debugd-laravel)[![License: MIT](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)](LICENSE)

Zero-instrumentation request tracing for Laravel — the passive collector for the [**debugd**](https://github.com/ShahramMebashar/debugd) server.

 [![debugd live UI](https://raw.githubusercontent.com/ShahramMebashar/debugd/main/app-screenshot.jpg)](https://raw.githubusercontent.com/ShahramMebashar/debugd/main/app-screenshot.jpg)

It quietly ships each request's queries, logs, timings, exceptions, and your own dumps to a local debugd server, which serves a live UI. When `DEBUGD_HOST` is unset, the package does **literally nothing** — no listeners, zero overhead — so it's safe to leave installed.

```
your Laravel app  ──POST /ingest──▶  debugd (one Go binary)  ──live UI──▶  your browser

```

> This is the read-only split of [`ShahramMebashar/debugd`](https://github.com/ShahramMebashar/debugd) (the `debugd-laravel/` directory). Open issues and PRs there.

Requirements
------------

[](#requirements)

- PHP `^8.2`
- Laravel 11, 12, or 13 (`illuminate/support` `^11 || ^12 || ^13`)

Install
-------

[](#install)

```
composer require --dev debugd/debugd-laravel
echo "DEBUGD_HOST=http://localhost:9100" >> .env
```

Start the [debugd server](https://github.com/ShahramMebashar/debugd) (`./bin/debugd --open`), hit any page that does some work, and the trace shows up instantly. Remove `DEBUGD_HOST` and the package goes inert again.

The service provider is auto-discovered — no manual registration needed.

The `debugd()` helper
---------------------

[](#the-debugd-helper)

Leave these in your code. They're a no-op in production (when `DEBUGD_HOST` is unset), and `bench()` still returns its result either way.

```
debugd($user);                                  // dump anything into the trace
debugd()->dump($payload, 'stripe response');    // ...with a label
$rows = debugd()->bench('report', fn () => Report::heavy());  // time it, get the result
debugd()->info('reached checkout', ['step' => 3]);

// run things in parallel (real parallelism under Octane, sequential otherwise),
// each shown as its own span:
[$user, $orders] = array_values(debugd()->concurrently([
    'user'   => fn () => User::find($id),
    'orders' => fn () => Order::recent($id),
]));
```

Configuration
-------------

[](#configuration)

Env varDefaultWhat`DEBUGD_HOST`*(unset)*debugd server URL. Unset = package fully disabled.`DEBUGD_CAPTURE_BINDINGS``false`Ship raw query bindings. Off by default — no values leave your app otherwise.How it works
------------

[](#how-it-works)

The package hangs off `DB::listen`, a Monolog handler, and the exception reporter, buffers everything per-request, and POSTs it from `terminate()` *after* the response is already sent — with tight timeouts and every failure swallowed, so tracing can't slow down or break a request. It's Octane- and FrankenPHP-safe (state is per-request, tested).

Not doing (on purpose)
----------------------

[](#not-doing-on-purpose)

No persistence, no production telemetry, no sampling, no auth. It's a local dev tool. The frozen wire format lives in [`PROTOCOL.md`](https://github.com/ShahramMebashar/debugd/blob/main/PROTOCOL.md).

License
-------

[](#license)

MIT.

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance90

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 Bus Factor1

Top contributor holds 66.7% 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

50d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/24a06f23ed335cd9eaeb5005340f4ab448b594d2678c835f3bbd716e97f747fa?d=identicon)[ShahramMebashar](/maintainers/ShahramMebashar)

---

Top Contributors

[![ShahramMebashar](https://avatars.githubusercontent.com/u/25268287?v=4)](https://github.com/ShahramMebashar "ShahramMebashar (2 commits)")[![talavoock](https://avatars.githubusercontent.com/u/3320280?v=4)](https://github.com/talavoock "talavoock (1 commits)")

###  Code Quality

TestsPest

### Embed Badge

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

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

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.2k](/packages/craftcms-cms)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k16](/packages/tempest-framework)[illuminate/http

The Illuminate Http package.

11937.9M7.5k](/packages/illuminate-http)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

293.1k](/packages/eslazarev-wildberries-sdk)[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

1189.8k](/packages/rcsofttech-audit-trail-bundle)

PHPackages © 2026

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