Logs in WordPress lesen und verstehen

Logs spielen eine zentrale Rolle bei der Diagnose und Lösung von Problemen in WordPress. Sie liefern detaillierte Informationen über Fehler, Warnungen und Prozesse, die im Hintergrund der Website stattfinden. In diesem Beitrag erkläre ich, wie du Logs lesen und interpretieren kannst, um deine WordPress-Website effizient zu debuggen.

Welche Logs gibt es in WordPress?

WordPress generiert verschiedene Arten von Logs, die je nach Fehlerquelle aufschlussreich sein können:

WP Debug Log: Beinhaltet PHP-Fehler und Warnungen, die durch das Aktivieren von WP Debug erstellt werden.
Server-Logs: Protokolle, die auf deinem Hosting-Server gespeichert werden, z. B. Apache- oder NGINX-Fehlerlogs.
Plugin- und Theme-Logs: Spezifische Protokolle von Plugins oder Themes, die eigenständig Fehler aufzeichnen können.

WP Debug Log finden

Der WP Debug Log wird nach der Aktivierung von WP Debug (siehe vorheriger Artikel) automatisch im Ordner /wp-content/debug.log erstellt. Öffne diese Datei mit einem einfachen Texteditor wie Notepad++ oder Visual Studio Code.

Aufbau eines Logs verstehen

Ein Log-Eintrag enthält mehrere Informationen:

[Datum Uhrzeit] PHP-Warnung: Beschreibung des Fehlers in /path/to/file.php Zeile 123

Datum und Uhrzeit: Wann der Fehler auftrat.
Fehlertyp: Beispielsweise PHP Warning, PHP Notice oder PHP Fatal Error.
Beschreibung: Gibt Details zum Fehler oder Hinweis.
Pfad und Zeile: Zeigt an, in welcher Datei und Zeile der Fehler auftrat.

Häufige Fehler und ihre Bedeutung

PHP Warning:

Diese Warnungen deuten auf ein potenzielles Problem hin, das die Funktionalität nicht unmittelbar beeinträchtigt, aber langfristig zu Problemen führen kann.
Beispiel:

PHP Warning: Undefined variable $name in /wp-content/themes/mytheme/functions.php on line 45

Ursache: Eine Variable wurde verwendet, bevor sie definiert wurde.

PHP Notice:

Eine noch weniger kritische Meldung als Warnings.
Beispiel:

PHP Notice: Undefined index: title in /wp-content/plugins/myplugin/main.php on line 23

Ursache: Ein Array-Schlüssel wurde abgefragt, der nicht existiert.

PHP Fatal Error:

Schwerwiegender Fehler, der das Laden einer Seite verhindert.
Beispiel:

PHP Fatal Error: Call to undefined function my_function() in /wp-content/plugins/myplugin/main.php on line 12

Ursache: Eine Funktion wurde aufgerufen, die nicht existiert.

Logs effizient lesen

Suche nach dem Zeitpunkt: Beginne mit den neuesten Einträgen, da diese häufig den aktuellen Fehler beschreiben.
Fokussiere dich auf Fatal Errors: Diese verursachen die größten Probleme und sollten zuerst gelöst werden.
Analysiere den Pfad: Der angegebene Pfad zeigt, ob der Fehler durch ein Theme, Plugin oder WordPress selbst verursacht wird.

Tools zum besseren Lesen von Logs

Texteditoren: Notepad++, Sublime Text oder Visual Studio Code unterstützen Syntax-Highlighting, was die Lesbarkeit verbessert.
WP Log Viewer: Ein Plugin, das die Anzeige von Logs direkt im WordPress-Dashboard ermöglicht.
Terminal-Tools: Nutze tail -f /path/to/debug.log, um Logs in Echtzeit zu verfolgen.

Fehler beheben

Sobald du die Ursache im Log identifiziert hast, gehst du folgendermaßen vor:

Korrigiere PHP-Fehler: Überarbeite die fehlerhafte Datei und behebe den Fehler.
Deaktiviere Plugins/Themes: Falls ein Plugin oder Theme die Ursache ist, deaktiviere es temporär und suche nach einem Update.
Aktualisiere WordPress: Möglicherweise wurde der Fehler in einer neueren Version behoben.

Logs zu lesen und zu verstehen, mag anfangs kompliziert wirken, wird aber schnell zur Routine. Mit ein wenig Übung kannst du Probleme präzise diagnostizieren und deine Website stabil halten.