1. Was ist Laravel Telescope und warum wird es benötigt?

Laravel Telescope ist ein leistungsstarkes Tool zum Debuggen und Überwachen von Laravel-Anwendungen, entwickelt vom Laravel-Team. Es bietet Entwicklern einen "Inspektor-Blick" auf das, was innerhalb der Anwendung passiert: von eingehenden Anfragen und SQL-Abfragen bis hin zu Queue-Jobs, Ausnahmen und Logs. Telescope fungiert als Dashboard, das in Echtzeit alle Telemetriedaten sammelt und anzeigt.

Warum ist das notwendig? In der modernen Webentwicklung werden Anwendungen immer komplexer: Es werden Queues, Caching, externe APIs und komplexe SQL-Abfragen verwendet. Ohne ein Tool wie Telescope müssten Entwickler manuell dd() oder Log::debug() in den Code einfügen, was die Entwicklung verlangsamt und kein vollständiges Bild liefert. Telescope sammelt automatisch Daten zu jeder Anfrage und zeigt Ausführungszeit, Anzahl der Datenbankabfragen, Speichernutzung und vieles mehr an. Das verwandelt Debugging von Ratespiel in exakte Wissenschaft.

Der Hauptvorteil von Telescope ist seine Unaufdringlichkeit. Es funktioniert "out of the box" und erfordert keine Code-Änderungen in der Anwendung. Die Daten werden in einer Datenbank (standardmäßig MySQL oder SQLite) gespeichert, sodass Sie den Verlauf der Anfragen analysieren können. Telescope ist besonders nützlich bei der API-Entwicklung, der Arbeit mit Queues und dem Debuggen langsamer Seiten.

2. Installation

Die Installation von Laravel Telescope erfolgt über Composer, den Standard-Paketmanager für PHP. Führen Sie den folgenden Befehl im Stammverzeichnis Ihres Laravel-Projekts aus:

composer require laravel/telescope --dev

Das Flag --dev ist wichtig: Telescope ist nur für die lokale Entwicklung gedacht und sollte nicht auf Produktionsservern installiert werden. Nach der Installation des Pakets müssen Sie die Assets (CSS/JS) und die Konfiguration veröffentlichen:

php artisan telescope:install

Dieser Befehl erstellt die Konfigurationsdatei config/telescope.php und eine Datenbankmigration. Führen Sie dann die Migration aus, um die Tabellen für die Telescope-Daten zu erstellen:

php artisan migrate

Danach ist Telescope unter der Adresse /telescope Ihrer Anwendung erreichbar. Wenn Sie Laravel Sail (Docker) verwenden, vergessen Sie nicht, die Container neu zu starten.

3. Schnellstart – Minimales Arbeitsbeispiel

Nach der Installation beginnt Telescope automatisch mit dem Sammeln von Daten. Sie müssen keinen zusätzlichen Code schreiben. Öffnen Sie einfach Ihren Browser und gehen Sie zu http://your-app.test/telescope.

Sie sehen ein Dashboard mit den Tabs: Requests, Commands, Schedule, Jobs, Exceptions, Logs, Dumps, Queries, Models, Mail, Notifications, Cache, Events, Gates.

Um zu überprüfen, ob alles funktioniert, führen Sie eine einfache Anfrage an eine beliebige Route Ihrer Anwendung aus. Öffnen Sie zum Beispiel die Startseite. Gehen Sie dann zu Telescope und wählen Sie den Tab Requests. Sie sehen einen Eintrag für Ihre Anfrage mit Details: Methode, URI, Status, Dauer, Anzahl der SQL-Abfragen usw.

Hier ist ein Beispiel, wie Sie manuell Daten zu Telescope für das Debugging hinzufügen können:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\User;
use Laravel\Telescope\Telescope;

class UserController extends Controller
{
    public function show($id)
    {
        // Telescope zeichnet diese Anfrage automatisch auf