Agile Developer Hilfe-Center › Agile Monitoring

PHP und Laravel einrichten

So erfassen Sie Fehler aus Laravel, Symfony, WordPress und reinem PHP.

Laravel

Für Laravel gibt es ein offizielles Open-Source-Fehler-SDK, das Ausnahmen, Warteschlangen und Befehle automatisch erfasst. Paketname und Code stehen in der Einrichtungs-Doku: https://monitor.agiledeveloper.de/docs/einrichten#php

  1. Legen Sie unter Projekte (/app/projekte) ein Projekt mit der Plattform PHP/Laravel an und kopieren Sie die DSN.
  2. Installieren Sie das SDK mit Composer.
  3. Tragen Sie die DSN in Ihre .env ein, in die Variable, die das SDK dafür vorsieht.
  4. Ab Laravel 11 registrieren Sie die Integration in bootstrap/app.php innerhalb von withExceptions.
  5. Leeren Sie den Konfigurations-Cache und senden Sie im Assistenten ein Test-Ereignis.

Setzen Sie APP_ENV korrekt. Die Umgebung wird mitgeschickt, sodass Sie Staging später ausfiltern können.

Symfony, WordPress und PHP ohne Framework

Auch dafür gibt es das offizielle PHP-SDK. Sie initialisieren es einmal früh im Code, etwa in einer Bootstrap-Datei oder bei WordPress in einem kleinen Plugin, mit DSN und Umgebung. Code dazu ebenfalls unter https://monitor.agiledeveloper.de/docs/einrichten#php

Ohne SDK: JSON-API

Wenn Sie keine Abhängigkeit installieren können, zum Beispiel auf einfachem Webspace, schicken Sie Fehler direkt an die JSON-API:

<?php
function fehler_melden(Throwable $f, array $extra = []): void {
    $daten = json_encode([
        'level'    => 'error',
        'umgebung' => getenv('APP_ENV') ?: 'production',
        'ausnahme' => [
            'typ'   => get_class($f),
            'wert'  => $f->getMessage(),
            'stack' => $f->getTraceAsString(),
        ],
        'url'   => $_SERVER['REQUEST_URI'] ?? null,
        'extra' => $extra,
    ]);
    $ch = curl_init('https://monitor.agiledeveloper.de/api/eingang/v1/ereignisse');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $daten,
        CURLOPT_HTTPHEADER     => [
            'Authorization: Bearer ' . getenv('MONITOR_SCHLUESSEL'),
            'Content-Type: application/json',
        ],
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 5,
    ]);
    curl_exec($ch);
    curl_close($ch);
}

set_exception_handler(function (Throwable $f) {
    fehler_melden($f);
    http_response_code(500);
});

Alle Felder der JSON-API: https://monitor.agiledeveloper.de/docs/einrichten#json-api

Frontend nicht vergessen

Das SDK erfasst Fehler auf dem Server. Fehler im Browser Ihrer Besucher, zum Beispiel in einem Theme-Script, erfassen Sie zusätzlich mit dem Browser-Script. Es genügt eine Zeile im Template, siehe Artikel „Website mit dem Browser-Script überwachen“.

Geplante Aufgaben

Für den Laravel-Scheduler oder WP-Cron lohnt ein Heartbeat. Hängen Sie an den Befehl einen Aufruf der Ping-Adresse an, dann merken Sie sofort, wenn der Scheduler nicht mehr läuft:

* * * * * php /var/www/artisan schedule:run && curl -fsS -m 10 https://monitor.agiledeveloper.de/api/ping/<token>

Datenschutz

Formulardaten mit Feldnamen wie password, token oder iban werden vor dem Speichern durch [gefiltert] ersetzt. Cookies und der Kopf Authorization werden nie gespeichert. Eigene Felder ergänzen Sie unter Projekte › Einstellungen › Datenschutz-Regeln.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 22. Oktober 2026

Weitere Artikel zu Agile Monitoring

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.