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
- Legen Sie unter Projekte (
/app/projekte) ein Projekt mit der Plattform PHP/Laravel an und kopieren Sie die DSN. - Installieren Sie das SDK mit Composer.
- Tragen Sie die DSN in Ihre
.envein, in die Variable, die das SDK dafür vorsieht. - Ab Laravel 11 registrieren Sie die Integration in
bootstrap/app.phpinnerhalb vonwithExceptions. - 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.