EN Anmelden Konto anlegen

Fehler-Monitoring für PHP.

Mit sentry/sentry meldet jede PHP-Anwendung Fehler und Ausnahmen an Fehlo, auch ohne Framework. Die Einrichtung ist ein Composer-Paket und ein Aufruf.

Konto anlegen

Stand: 24.10.2026, sentry/sentry 4.34.0, PHP ab 7.2 mit den Erweiterungen curl, json und mbstring. Das PHP-SDK haben wir noch nicht selbst gegen Fehlo laufen lassen; es spricht dasselbe Protokoll wie die getesteten SDKs.

Für PHP ohne Framework, ältere Eigenentwicklungen oder Frameworks ohne eigenes Paket. Für Laravel und Symfony gibt es eigene Anleitungen.

1. Paket installieren

Terminal
composer require sentry/sentry

2. SDK starten

So früh wie möglich, direkt nach dem Autoloader von Composer, in deinem Front-Controller oder deiner Bootstrap-Datei:

public/index.php
<?php

require __DIR__ . '/../vendor/autoload.php';

\Sentry\init([
    'dsn' => 'https://<key>@app.fehlo.de/<project-id>',
    'environment' => 'production',
    'release' => 'my-app@1.0.0',
    'send_default_pii' => false,
]);

Das Beispiel in Sentrys Dokumentation setzt send_default_pii auf true. Übernimm das nicht ungeprüft: Dann gehen Header, Cookies und IP-Adressen mit. Statt im Code kannst du die Werte auch aus der Umgebung lesen lassen:

.env oder Server-Umgebung
SENTRY_DSN=https://<key>@app.fehlo.de/<project-id>
SENTRY_ENVIRONMENT=production
SENTRY_RELEASE=my-app@1.0.0

3. Testen

Unbehandelte Ausnahmen meldet das SDK selbst. Eine abgefangene meldest du so:

test.php
try {
    throw new \RuntimeException('Fehlo test error');
} catch (\Throwable $exception) {
    \Sentry\captureException($exception);
}

Der Fehler erscheint nach wenigen Sekunden in Fehlo, mit Stacktrace und Code-Kontext.

Argumente im Stacktrace

Damit Stacktraces die Argumente der Funktionen zeigen, braucht PHP zend.exception_ignore_args = Off in der php.ini. In Produktionskonfigurationen steht das oft auf On. Mit Off landen auch Argumentwerte in den Ereignissen; Passwörter und Tokens filtert Fehlo serverseitig heraus.

Datenschutz

send_default_pii ist standardmäßig false. Seit Version 4.33 gibt es zusätzlich data_collection. Setz data_collection nicht: Sobald es gesetzt ist, gelten dessen freizügigere Standards, und das SDK sendet IP-Adressen, Cookies und Bodies mit. Fehlo entfernt die Absender-IP und filtert E-Mail-Adressen, Passwörter und Tokens.

Häufige Fragen

Es kommt nichts an. Was prüfe ich?

Erstens den DSN: Er muss auf app.fehlo.de zeigen. Zweitens, ob dein Server oder Browser https://app.fehlo.de erreicht (Firewall, Proxy, Werbeblocker). Drittens, ob dein Kontingent für den Monat aufgebraucht ist; dann bekommst du eine Mail. Viertens, ob sampleRate oder beforeSend Ereignisse verwirft. Fehlen nur Performance-Daten, sind vielleicht die Transaktionen des Monats aufgebraucht.

Weiterlesen