Laravel Pail : logs PHP en temps réel

📚 Introduction

Pendant des années, “lire ses logs Laravel en local” voulait dire tail -f storage/logs/laravel.log, ouvrir le résultat dans less, et chercher l’aiguille dans la botte de foin. Sur un projet un peu actif, c’était inutilisable.

Laravel Pail change la donne. C’est un outil officiel, installable en quelques secondes, qui transforme le terminal en un tail interactif filtrable, conscient du format des logs Laravel, et capable d’afficher proprement les stack traces.

🚀 Installation et premier lancement

L’installation tient en une commande :

composer require laravel/pail --dev

Et le lancement, en une autre :

php artisan pail

À partir de là, chaque log émis par l’application apparaît dans le terminal, formaté, coloré, avec le contexte étendu. Plus besoin de tail -f ni d’aller fouiller dans storage/logs/.

🔍 Les filtres qui font tout

Pail prend son sens dès qu’on apprend ses filtres. Les plus utiles au quotidien :

# Uniquement les logs de niveau warning ou supérieur
php artisan pail --filter=warning
 
# Uniquement les messages contenant "invoice"
php artisan pail --message="invoice"
 
# Uniquement les logs émis par le job SendInvoiceEmail
php artisan pail --filter=SendInvoiceEmail
 
# Uniquement les requêtes HTTP qui durent plus de 500 ms
php artisan pail --filter=slow

Les filtres se combinent, ce qui permet de cibler exactement le bruit qu’on veut entendre sans avoir à recompiler une commande grep à chaque fois.

🧠 Lecture des stack traces

Les exceptions étaient le grand sujet douloureux des fichiers laravel.log. Pail affiche les stack traces avec un formatage qui rend immédiatement lisible :

Les fichiers et lignes en couleurs différenciées.
Le code applicatif distingué du code vendor.
Les variables locales contextualisées au niveau de la frame fautive.

Pour un développeur qui passe la moitié de sa journée à diagnostiquer des bugs, c’est probablement la fonctionnalité qui change le plus le quotidien.

🧰 Quand Pail s’arrête, où regarder ensuite

Pail est conçu pour le développement local et les sessions d’investigation rapides. En production, il ne remplace pas une stack d’observabilité comme SigNoz ou un agrégateur de logs distant. L’idée est plutôt :

En local et en staging : Pail, parce que le feedback immédiat compte plus que la rétention longue durée.
En production : OpenTelemetry → SigNoz (ou équivalent), parce que la corrélation logs / traces / métriques devient le sujet principal.

Pour un développeur qui veut un tour d’horizon des bonnes pratiques de logs côté Laravel, c’est aussi l’occasion de relire ses canaux de logs et de séparer proprement les flux applicatifs des flux d’audit.

🤖 Pail et les agents IA

Avec Laravel Boost, les logs deviennent un input intéressant pour un agent : analyser une exception, expliquer ce qui s’est passé, proposer un correctif. Pail facilite ce workflow parce qu’il produit en sortie un texte structuré et lisible, qu’on peut piper directement vers un assistant ou intégrer dans une session Claude Code.

C’est typiquement le genre d’enchaînement que je commence à mettre en place sur mes projets :

php artisan pail --filter=error --since="10m" | pbcopy

Et l’agent peut ensuite analyser le snapshot, le corréler avec le code, et proposer un fix testable.

⚠️ Quelques bonnes pratiques

Ajoutez Pail uniquement en require-dev : ce n’est pas un outil de production.
Activez le format JSON de log dans Laravel pour bénéficier pleinement des filtres : Pail tire parti des champs structurés (level, context, request_id).
Configurez un canal de log dédié pour le dev (stderr ou pail) plutôt que d’écrire dans storage/logs/laravel.log qui restera lu par d’autres outils.

🎉 Conclusion

Laravel Pail est un de ces petits outils qui font une grosse différence : pas de paradigme révolutionnaire, juste une expérience de logs locale enfin agréable. Sur les sessions de débogage, le gain de temps est mesurable dès la première heure.

Si vous travaillez sur Laravel et que vous n’avez pas encore installé Pail, c’est la prochaine commande à taper. C’est trivialement réversible et l’ergonomie change immédiatement.

📜 Laravel Pail : tailler ses logs en temps réel, enfin