Laravel Vitals v1.0
Star 3 Install
Documentation

De composer require au premier audit en cinq minutes.

Un fichier de config, une commande artisan. Tout le reste tient dans les sections ci-dessous.

Démarrer API JSON — référence
Install rapide · PHP 8.2+ · Laravel 11 / 12 / 13
C'est quoi Laravel Vitals

Lighthouse, et le contexte serveur qui a produit le score.

Laravel Vitals lance Google Lighthouse sur vos propres pages, capture ce que votre serveur faisait à ce moment précis — requêtes, mémoire, problèmes N+1 — et pointe directement les lignes de code responsables. Tout atterrit dans un dashboard sur /vitals que toute l'équipe peut lire et exploiter. Vos données restent dans votre base — pas de SaaS, pas de facturation à l'utilisateur.

Audits Lighthouse — 4 drivers
Télémétrie backend par audit
Attribution fichier:ligne
Real User Monitoring
Démarrage rapide

Installez, déclarez une URL, lancez un audit.

Installation bash 
composer require corentinbtmps/laravel-vitals
php artisan vendor:publish --tag=vitals-config
php artisan migrate
php artisan vitals:install
Ajoutez le RUM dans votre layout blade 
<head>
    <meta charset="utf-8">
    @vitalsRum
</head>
Déclarez une URL (config/vitals.php) php 
'urls' => ['home' => '/'],
Premier audit bash 
php artisan vitals:audit home --sync

Ouvrez /vitals — score Lighthouse, télémétrie backend et recommandations avec leurs références fichier:ligne.

Architecture

Le déroulé concret d'un audit.

  1. 1

    Déclarez vos URLs

    config/vitals.php liste vos URLs sous la forme label => /chemin. Lancez vitals:audit à la main, sur un schedule ou depuis votre CI.

  2. 2

    L'audit démarre

    Le package signe un en-tête X-Vitals-Audit-Id avec votre APP_KEY et déclenche Lighthouse (Node local, Playwright, ou l'API Google PageSpeed selon votre driver).

  3. 3

    Télémétrie backend

    Pendant que Lighthouse charge la page, votre middleware détecte l'en-tête signé et enregistre nombre de requêtes, temps de requête, suspicion N+1, pic mémoire, vues rendues, jobs, hits/misses de cache.

  4. 4

    Résultat Lighthouse

    Les scores arrivent (0–100) avec les valeurs brutes : LCP, INP, CLS, TTFB, FCP, TBT, Speed Index.

  5. 5

    Analyse de code

    Des analyseurs statiques scannent vos vues Blade, votre config Vite et votre composer.json pour attacher un fichier:ligne précis à chaque finding Lighthouse. Tout est stocké et exposé sur /vitals.

Base de connaissances

Chaque métrique, expliquée en clair.

Une page Learn par métrique Lighthouse — LCP, INP, CLS, TTFB. Trois phrases, le seuil, le lien vers la référence Web Vitals. Pratique pour onboarder les nouveaux devs.

Parcourir

Référence complète sur GitHub.

Le README couvre toutes les commandes Artisan, les endpoints de l'API JSON, la surface de configuration (~30 réglages override via .env), les garanties de confidentialité, le troubleshooting et les guidelines de contribution.

Voir le README sur GitHub