PHPackages                             lampyra/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. [Logging &amp; Monitoring](/categories/logging)
4. /
5. lampyra/laravel

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

lampyra/laravel
===============

Self-hosted, lightweight exception capture for Laravel apps. Ships exceptions to a lampyra-server instance.

v0.2.0(2w ago)030↓33.3%MITPHPPHP ^8.3

Since May 20Pushed 2w agoCompare

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

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

lampyra/laravel
===============

[](#lampyralaravel)

Composer package for shipping PHP exceptions and JavaScript errors from a Laravel app to a self-hosted [Lampyra](https://github.com/seebaermichi/lampyra) dashboard.

60-second install
-----------------

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

Full documentation
------------------

[](#full-documentation)

The complete reference lives on the dashboard. Replace `` below with your deployed instance:

- **English:** `https://errors..com/docs/en/package/01-installation`
- **Deutsch:** `https://errors..com/docs/de/package/01-installation`

Topics covered there:

- Installation, configuration, env vars
- The `lampyra:test` command
- Payload structure and PII scrubbing
- Local rate limit
- JavaScript error capture via `@lampyra`
- Ingest API contract
- Troubleshooting

PII scrubbing — quick reference
-------------------------------

[](#pii-scrubbing--quick-reference)

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

1. **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`.
2. **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]',
    ],
    ```
3. **User email** — set `LAMPYRA_INCLUDE_USER_EMAIL=false` to drop `payload.user.email`. The user id is always sent.

License
-------

[](#license)

MIT.

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance97

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

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 ~2 days

Total

3

Last Release

15d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2083999?v=4)[MichaB](/maintainers/seebaermichi)[@seebaermichi](https://github.com/seebaermichi)

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[spatie/laravel-health

Monitor the health of a Laravel application

88011.3M149](/packages/spatie-laravel-health)[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k51.0M7.4k](/packages/larastan-larastan)[spatie/laravel-export

Create a static site bundle from a Laravel app

670139.5k6](/packages/spatie-laravel-export)[simplestats-io/laravel-client

Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof.

5019.3k](/packages/simplestats-io-laravel-client)[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1232.2k16](/packages/fleetbase-core-api)

PHPackages © 2026

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