Logging in PHP-Anwendungen: Best Practices in der Praxis

Online Python-Trainer für Anfänger

Lernen Sie Python einfach ohne theoretische Überlastung. Lösen Sie praktische Aufgaben mit automatischer Überprüfung und schreiben Sie Code direkt im Browser.

Kurs starten

Logging in PHP-Anwendungen: Best Practices in der Praxis

Logging ist nicht nur das Aufzeichnen von Fehlern in eine Datei. Es ist ein strategisches Werkzeug für Monitoring, Debugging und Auditing des Anwendungsbetriebs. In diesem Artikel werden wir uns ansehen, wie man Logging in PHP in der Praxis organisiert, unter Verwendung moderner Ansätze und Bibliotheken. Sie erfahren, wie Sie typische Fehler vermeiden und Logs wirklich nützlich machen.

1. Bibliotheksauswahl und der PSR-3-Standard

In der modernen PHP-Community ist der De-facto-Standard das Interface PSR-3 (Logger Interface). Es definiert einen einheitlichen Satz von Methoden für das Logging, was einen einfachen Wechsel der Logging-Bibliothek ohne Umschreiben des Anwendungscodes ermöglicht.

Die beliebteste Implementierung von PSR-3 ist die Bibliothek Monolog. Sie ist flexibel, leistungsstark und verfügt über zahlreiche "Handler" zum Senden von Logs an Dateien, Datenbanken, Slack, Telegram, E-Mail und Cloud-Dienste.

Installation von Monolog via Composer:

composer require monolog/monolog

Basisbeispiel zur Verwendung:

<?phprequire 'vendor/autoload.php';

use Monolog\\Logger;use Monolog\\Handler\\StreamHandler;

// Erstellen eines Log-Kanals (channel) – normalerweise nach Anwendungs- oder Modulname$log = new Logger('my_app');// Handler hinzufügen: Logs ab Level WARNING und höher in eine Datei schreiben$log->pushHandler(new StreamHandler(__DIR__ . '/logs/app.log', Logger::WARNING));

// Jetzt kann geloggt werden$log->warning('Benutzer {username} versuchte sich mit falschem Passwort anzumelden', ['username' => 'ivan']);$log->error('Verbindung zur Datenbank fehlgeschlagen: {error}', ['error' => $e->getMessage()]);?>

Warum ist das wichtig? Die Verwendung von PSR-3 macht Ihren Code unabhängig von einer bestimmten Bibliothek. Wenn Sie morgen von Monolog zu einer anderen Implementierung (z. B. Log4php) wechseln möchten, müssen Sie nur die Initialisierung des Loggers ändern, nicht aber alle Stellen, an denen $log->error() aufgerufen wird.

2. Log-Level: Wann was verwenden

PSR-3 definiert 8 Log-Level (vom niedrigsten zum höchsten Priorität): DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. Die korrekte Verwendung der Level ist die Grundlage für lesbare und nützliche Logs.

DEBUG – detaillierte Debug-Informationen, die nur der Entwickler benötigt (Variablenwerte, Aufruf-Traces). Nur in der Dev-Umgebung aktivieren.
INFO – wichtige Ereignisse im Anwendungsbetrieb: Benutzer registriert, Bestellung erstellt, Cron-Job ausgeführt.
NOTICE – normale, aber signifikante Ereignisse (z. B. Nutzung einer veralteten API).
WARNING – potenzielle Probleme, die die Skriptausführung nicht gestoppt haben (fehlgeschlagener Anmeldeversuch, langsame Datenbankabfrage).
ERROR – Fehler, die ein Eingreifen erfordern: Ausnahmen, Ausfälle externer Dienste.
CRITICAL – kritische Ausfälle: Verbindungsverlust zur Datenbank, Speichermangel.
ALERT – sofortiges Handeln des Administrators erforderlich (Website nicht erreichbar).
EMERGENCY – das gesamte System ist nicht funktionsfähig.

Praktischer Tipp: Konfigurieren Sie verschiedene Handler für verschiedene Level. Zum Beispiel: WARNING und höher in eine Datei schreiben, ERROR und höher zusätzlich an Telegram/Slack senden.

// Beispiel: Zwei Handler für einen Logger$log->pushHandler(new StreamHandler(__DIR__ . '/logs/all.log', Logger::DEBUG));$log->pushHandler(new StreamHandler(__DIR__ . '/logs/errors.log', Logger::ERROR));// Für kritische Fehler – Senden an Telegram$log->pushHandler(new TelegramBotHandler('TOKEN', 'CHAT_ID', Logger::CRITICAL));