Laravel Telescope

Laravel Telescope est votre assistant de débogage ultime : il offre une vue en temps réel des queries, exceptions, du cache et des logs de votre application. Comprenez et corrigez les problèmes plus vite.

22 mars 2025 · 3 minutes de lecture

Voir la source

Christophe

Amoureux de Markdown, WSL et Docker ~ Curieux insatiable.

Cet article existe aussi en anglais — lire la version originale.

Traduction automatique

Cette traduction a été produite par une IA. Elle peut contenir des contresens ou des maladresses, en particulier sur les termes techniques. En cas de doute, consultez l'article de référence en anglais — c'est lui qui fait foi.

Cet article a plus d'un an, mais il a été relu le 30 juillet 2026 — son contenu est toujours exact.

Laravel Telescope

⚡

TL;DR

Laravel Telescope est un élégant assistant de débogage pour vos applications Laravel. Cet article présente Telescope et explique comment il donne une vue claire, en temps réel, des rouages internes de votre application. De l'inspection des queries et des exceptions au suivi de l'utilisation du cache et des logs, Telescope vous donne le contexte nécessaire pour comprendre et résoudre les problèmes rapidement. C'est un outil indispensable en développement local comme pour surveiller une application sur un serveur de test, ce qui permet d'identifier et de corriger les problèmes de façon proactive.

Je ne travaille pas si souvent avec Laravel (l'un des frameworks PHP les plus connus), du coup je perds un peu mes réflexes quand il s'agit de déboguer le code : par exemple retrouver les queries exécutées, les exceptions levées, la liste des clés créées ou lues depuis le cache Redis, etc.

En installant Laravel Telescope, on obtient des informations en temps réel sur le cache, les logs, les queries et les modèles, les exceptions, ... et cela aide énormément à comprendre comment l'application fonctionne et ce qui s'exécute.

Telescope est une aide précieuse pour déboguer et comprendre votre application, et il s'installe comme une dépendance de dev.

La dernière fois que j'ai développé une application Laravel et que je l'ai installée sur le serveur de test, j'ai pu suivre en temps réel ce que faisait mon utilisateur, voir les exceptions qu'il rencontrait et les corriger ... avant même qu'il ne me les signale.

Grâce à Telescope, non seulement j'avais une vue parfaite de ce qui était collecté, mais j'avais aussi tout le contexte : l'utilisateur n'a pas eu à me dire « Ça ne marche pas... » (sans le moindre détail) ; j'avais tout sous la main.

Dashboard

Pour un modèle Eloquent par exemple, on retrouvera dans Telescope (l'URL par défaut est http://your_site/telescope) le SQL brut : facile à copier/coller et à exécuter directement dans pgadmin par exemple.

Pour le cache Redis par exemple, on verra les clés et si elles ont été lues (hits) ou créées (set).

Laravel Telescope peut aussi être installé sur un serveur de test pour voir ce que fait l'utilisateur et obtenir tout le contexte de chaque requête. Ainsi, quand une exception est levée, on peut la retrouver dans le log, avec le message d'exception, les données POST, l'URL utilisée et bien plus encore.

Telescope représente une vraie avancée pour le débogage d'une application Laravel. Consultez la documentation officielle pour apprendre à l'installer et à l'utiliser.

Deux autres articles Laravel sur ce blog : Travailler avec les events Laravel — et il se trouve que Telescope vous montre chaque événement déclenché, ce qui en fait un excellent compagnon pendant l'apprentissage — et Laravel Filament.

🦋 Rejoignez la conversation sur Bluesky

Aimer, partager ou commenter sur Bluesky

Un compte Bluesky gratuit est nécessaire pour aimer, repartager ou commenter. Ce bloc interroge l'API publique de Bluesky directement depuis votre navigateur (sans cookie, sans connexion) — votre adresse IP parvient donc aux serveurs de Bluesky dès que cette section se charge.

Chargement des commentaires…