Laravel Vitals v1.0
Star 3 Install
Dokumentation

Alles, was du brauchst, um Laravel zu instrumentieren.

Das Paket enthält eine einzige Konfigurationsdatei und einen artisan-Befehl. Die meisten Teams führen ihren ersten Audit innerhalb von 5 Minuten nach composer require durch.

Loslegen JSON-API-Referenz
Schnellinstallation · PHP 8.2+ · Laravel 11 / 12 / 13
Was ist Laravel Vitals

Lighthouse, plus der Server-Kontext, der den Score erzeugt hat.

Laravel Vitals lässt Google Lighthouse auf Ihre eigenen Seiten los, erfasst, was Ihr Server in genau diesem Moment getan hat — Queries, Speicher, N+1-Probleme — und zeigt direkt auf die verantwortlichen Codezeilen. Alles landet in einem Dashboard unter /vitals, das jedes Teammitglied lesen und nutzen kann. Ihre Daten bleiben in Ihrer eigenen Datenbank — kein SaaS, keine Abrechnung pro Sitz.

Lighthouse-Audits — 4 Treiber
Backend-Telemetrie pro Audit
file:line-Zuordnung
Real User Monitoring
Schnellstart

Installieren, URL deklarieren, Audit starten.

Installation bash 
composer require corentinbtmps/laravel-vitals
php artisan vendor:publish --tag=vitals-config
php artisan migrate
php artisan vitals:install
RUM im Layout einbinden blade 
<head>
    <meta charset="utf-8">
    @vitalsRum
</head>
URL deklarieren (config/vitals.php) php 
'urls' => ['home' => '/'],
Erster Audit bash 
php artisan vitals:audit home --sync

Öffnen Sie /vitals — Lighthouse-Score, Backend-Telemetrie und Empfehlungen mit file:line-Referenzen.

Architektur

Wie ein Audit tatsächlich abläuft.

  1. 1

    URLs deklarieren

    config/vitals.php enthält Ihre URLs als label => /path-Paare. Starten Sie vitals:audit manuell, per Schedule oder aus der CI.

  2. 2

    Audit startet

    Das Paket signiert einen X-Vitals-Audit-Id-Header mit Ihrem APP_KEY und startet Lighthouse (lokaler Node, Playwright oder Google PageSpeed API — je nach Treiber).

  3. 3

    Backend-Telemetrie

    Während Lighthouse die Seite lädt, erkennt Ihre Middleware den signierten Header und erfasst Query-Anzahl, Query-Zeit, N+1-Verdacht, Speicherspitze, Views, Jobs und Cache-Treffer/-Fehler.

  4. 4

    Lighthouse-Ergebnis

    Scores kommen an (0–100) zusammen mit den Rohwerten: LCP, INP, CLS, TTFB, FCP, TBT, Speed Index.

  5. 5

    Code-Analyse

    Statische Analysatoren scannen Ihre Blade-Views, Ihre Vite-Config und Ihre composer.json, um jedem Lighthouse-Finding ein genaues file:line anzuhängen. Alles wird gespeichert und unter /vitals angezeigt.

Wissensdatenbank

Verständliche Erklärungen zu jeder Metrik.

Jede Lighthouse-Metrik — LCP, INP, CLS, TTFB — hat eine "Learn"-Seite, die sie in drei Sätzen erklärt, den Schwellenwert zeigt und auf die Web-Vitals-Referenz verweist. Hilfreich beim Onboarding neuer Entwickler.

Durchsuchen

Vollständige Referenz auf GitHub.

Das README deckt alle Artisan-Befehle ab, die JSON-API-Endpoints, die Konfigurationsfläche (~30 per .env überschreibbare Stellschrauben), die Privacy-Garantien, Troubleshooting und Contribution-Guidelines.

README auf GitHub ansehen