README

Composer package for shipping PHP exceptions and JavaScript errors from a Laravel app to a self-hosted Lampyra dashboard.

60-second install

composer require lampyra/laravel

Add to .env:

LAMPYRA_DSN="https://errors.your-domain.com|slk_your_ingest_token"
LAMPYRA_PUBLIC_DSN="paste_24_char_public_dsn"
LAMPYRA_ENABLED=true

Verify:

php artisan lampyra:test

For browser error capture, drop @lampyra in your main Blade layout's <head>.

The complete reference lives on the dashboard. Replace <your-domain> below with your deployed instance:

Topics covered there:

The outgoing payload is scrubbed in two passes (see config/lampyra.php):

Key-name pass (scrub_keys) — redacts values whose key matches a pattern. Recursive, case-insensitive, supports *suffix / prefix* wildcards. Use for known field names like password, *_secret, authorization.
Value-pattern pass (scrub_value_patterns) — runs regex replacements over every string leaf. Use for PII that key matching cannot reach: data inside JSON-encoded request.body_excerpt, positional queries[].bindings, or values interpolated into exception.message. Example:
```
'scrub_value_patterns' => [
    '/\b[A-Z]{2}\d{2}[A-Z0-9]{10,30}\b/' => '[iban-scrubbed]',
    '/[\w\.\-]+@[\w\-]+(?:\.[\w\-]+)+/' => '[email-scrubbed]',
],
```
User email — set LAMPYRA_INCLUDE_USER_EMAIL=false to drop payload.user.email. The user id is always sent.

MIT.