PHPackages                             bug-collector/laravel-client - 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. [Logging & Monitoring](/categories/logging)
4. /
5. bug-collector/laravel-client

ActiveLibrary[Logging & Monitoring](/categories/logging)

bug-collector/laravel-client
============================

Client Laravel pour Bug Collector : reporte les erreurs et les anomalies de performance (requêtes, jobs, queries, commandes lentes) à un service Bug Collector centralisé.

v1.1.0(1mo ago)0721MITPHPPHP ^8.2CI passing

Since Jun 27Pushed 1mo agoCompare

[ Source](https://github.com/hugo-bachmann/laravel-bug-collector-client)[ Packagist](https://packagist.org/packages/bug-collector/laravel-client)[ Docs](https://github.com/hugo-bachmann/laravel-bug-collector-client)[ RSS](/packages/bug-collector-laravel-client/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (3)Dependencies (13)Versions (6)Used By (0)

Bug Collector — Client Laravel
==============================

[](#bug-collector--client-laravel)

[![tests](https://github.com/hugo-bachmann/laravel-bug-collector-client/actions/workflows/tests.yml/badge.svg)](https://github.com/hugo-bachmann/laravel-bug-collector-client/actions/workflows/tests.yml)[![lint](https://github.com/hugo-bachmann/laravel-bug-collector-client/actions/workflows/lint.yml/badge.svg)](https://github.com/hugo-bachmann/laravel-bug-collector-client/actions/workflows/lint.yml)[![Packagist Version](https://camo.githubusercontent.com/7b8cac49fc629bfd53610b1bd930fdeba02a6cc3d530f66b46305e8571fd8d3d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6275672d636f6c6c6563746f722f6c61726176656c2d636c69656e74)](https://packagist.org/packages/bug-collector/laravel-client)[![License](https://camo.githubusercontent.com/34ef22d681f326b52a099ff9963dcec04d98456f66a8b2f06e4f4b84502b3385/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6275672d636f6c6c6563746f722f6c61726176656c2d636c69656e74)](LICENSE)

Client Laravel pour [Bug Collector](https://github.com/hugo-bachmann/bug-collector) : reporte automatiquement les **erreurs** et les **anomalies de performance** (requêtes HTTP, jobs, queries SQL, commandes artisan trop lentes) à un service Bug Collector centralisé.

Compatibilité
-------------

[](#compatibilité)

PackagePHPLaravel1.x8.2 – 8.412 · 13L'instrumentation et le transport sont implémentés. L'authentification se fait via le header `X-Ingest-Key` ; l'envoi est fail-safe (une panne du collecteur ne casse jamais l'app hôte) ; les seuils de performance sont configurables.

Installation
------------

[](#installation)

```
composer require bug-collector/laravel-client
```

Puis dans le `.env` de l'app cliente :

```
BUG_COLLECTOR_URL="https://"
BUG_COLLECTOR_INGEST_KEY=""
```

`BUG_COLLECTOR_URL` est la **racine** du service Bug Collector. Le client ajoute automatiquement `/api/laravel-bugs/add` pour les erreurs et `/api/laravel-perf/add` pour la performance.

Le ServiceProvider est auto-découvert — rien à enregistrer à la main.

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

[](#configuration)

```
php artisan vendor:publish --tag=bug-collector-config
```

Voir `config/bug-collector.php` pour les seuils de performance (en millisecondes) :

TypeDéfaut`request`2000 ms`job`30000 ms`query`1000 ms`command`60000 msCookies
-------

[](#cookies)

La capture des cookies est **désactivée par défaut** (opt-in via `BUG_COLLECTOR_SEND_COOKIES=true`). Quand elle est activée, sont automatiquement remplacés par `[REDACTED]` :

- la session Laravel et `XSRF-TOKEN` ;
- tout cookie commençant par `remember_` ;
- tout cookie dont le nom contient `token`, `auth`, `session`, `csrf`, `secret` ou `password` (insensible à la casse).

Pour masquer des noms supplémentaires (cookies d'auth/JWT custom), listez-les en CSV via `BUG_COLLECTOR_REDACT_COOKIES="tenant_id,locale_pref"`.

Sécurité & confidentialité
------------------------------

[](#sécurité--confidentialité)

- **HTTPS requis.** `BUG_COLLECTOR_URL` doit être en `https://` (sauf `localhost`/`127.0.0.1` en dev). Sinon le client se **désactive automatiquement** pour ne jamais transmettre la clé d'ingestion ni les données en clair.
- **Paramètres d'URL sensibles masqués.** Les valeurs des paramètres de query courants (`token`, `signature`, `password`, `secret`, `api_key`, `code`, `otp`…) sont remplacées par `[REDACTED]` avant l'envoi.
- **Args de stack trace exclus** : seuls fichier / ligne / fonction / classe sont remontés.
- **Attention aux messages d'exception et au SQL brut.** Le message d'exception (`getMessage()`) et le label des requêtes lentes sont envoyés **verbatim**. Les requêtes Eloquent gardent leurs placeholders (`?`), mais le SQL brut (`whereRaw`, `DB::raw`) et les messages d'exception peuvent contenir des littéraux sensibles — évitez d'y placer des secrets.
- **Latence.** L'envoi est synchrone au `terminate` (après la réponse / la commande), borné par `BUG_COLLECTOR_TIMEOUT` (2 s par défaut) ; toute erreur réseau est avalée.

Développement
-------------

[](#développement)

```
composer install
composer test       # phpunit
composer lint       # pint --test (vérifie le style)
composer format     # pint (corrige le style)
composer analyse    # phpstan (analyse statique, niveau 6)
```

L'intégration continue exécute la suite de tests sur la matrice PHP 8.2/8.3/8.4 × Laravel 12/13, ainsi que Pint et PHPStan.

Licence
-------

[](#licence)

Ce package est distribué sous licence [MIT](LICENSE).

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance92

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

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

Every ~1 days

Total

5

Last Release

41d ago

Major Versions

v0.1.2 → v1.0.12026-07-01

### Community

Maintainers

![](https://www.gravatar.com/avatar/f6e9ce794852c5d8707c3fbb45b73d055400d56b3d7b5ea83509a3446fcde73a?d=identicon)[hugo-bachmann](/maintainers/hugo-bachmann)

---

Top Contributors

[![hugo-bachmann](https://avatars.githubusercontent.com/u/61874297?v=4)](https://github.com/hugo-bachmann "hugo-bachmann (37 commits)")

---

Tags

laravelmonitoringerror-reportingperformancebug-collector

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/bug-collector-laravel-client/health.svg)

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

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.4M354](/packages/psalm-plugin-laravel)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

79227.1M213](/packages/laravel-mcp)[api-platform/laravel

API Platform support for Laravel

58190.1k21](/packages/api-platform-laravel)[forjedio/inertia-table

Backend-driven dynamic tables for Laravel + Inertia.js

272.0k](/packages/forjedio-inertia-table)

PHPackages © 2026

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