Debugging bezeichnet das systematische Aufspüren und Beheben von Fehlern in Software; in WordPress geschieht das vor allem über spezielle Debug-Konstanten in der Datei wp-config.php.
Was bedeutet das?
Jede Software enthält Fehler (Bugs). Beim Debugging geht es darum, diese Fehler zu lokalisieren, ihre Ursache zu verstehen und sie zu beheben. WordPress hat dafür ein eingebautes Debug-System, das über die zentrale Konfigurationsdatei wp-config.php gesteuert wird. Standardmäßig sind alle Debug-Ausgaben deaktiviert, damit auf Produktionssystemen keine technischen Fehlermeldungen für Besucher sichtbar werden.
Die wichtigste Konstante ist WP_DEBUG. Wird sie auf true gesetzt, gibt WordPress PHP-Fehler, Warnungen und Hinweise direkt im Browser aus. Für Produktionsumgebungen ist das ungeeignet, weil Fehlermeldungen interne Dateipfade und Versionsinformationen preisgeben. Die sichere Alternative für Live-Websites kombiniert drei Konstanten: define( 'WP_DEBUG', true ); aktiviert die Fehlererfassung, define( 'WP_DEBUG_LOG', true ); schreibt Fehler in die Datei wp-content/debug.log, und define( 'WP_DEBUG_DISPLAY', false ); verhindert die Ausgabe im Browser. Damit sammeln Sie Fehlermeldungen, ohne sie Besuchern zu zeigen.
Weitere hilfreiche Konstanten: SCRIPT_DEBUG lädt unkomprimierte Versionen von WordPress-eigenen CSS- und JavaScript-Dateien, was die Fehlersuche im Frontend-Code erleichtert. SAVEQUERIES speichert alle Datenbankabfragen mit Ausführungszeiten im Arbeitsspeicher, sodass Performance-Engpässe auf langsame Datenbankabfragen zurückgeführt werden können. Das Plugin Query Monitor greift auf diese Daten zu und zeigt sie als übersichtliches Admin-Bar-Overlay an.
Beispiel aus der Praxis
Nach der Installation eines neuen Plugins erscheint beim Aufrufen einer bestimmten Seite ein weißer Bildschirm (White Screen of Death). Sie öffnen wp-config.php per FTP, setzen WP_DEBUG auf true, WP_DEBUG_LOG auf true und WP_DEBUG_DISPLAY auf false. Nach dem nächsten Seitenaufruf enthält die Datei wp-content/debug.log einen PHP-Fatal-Error mit Dateiname und Zeilennummer des fehlerhaften Plugins. Sie deaktivieren das Plugin, der weiße Bildschirm verschwindet, und Sie melden den Fehler dem Plugin-Entwickler. Nach Abschluss der Fehlersuche setzen Sie WP_DEBUG wieder auf false.
Häufiger Fehler
WP_DEBUG auf einer Produktions-Website dauerhaft auf true zu belassen ist ein weit verbreiteter Fehler. Die dabei angezeigten Meldungen enthalten oft absolute Dateipfade wie /var/www/.../wp-content/plugins/mein-plugin/klasse.php. Diese Details helfen Angreifern, die Serverstruktur zu kartieren und gezielt Schwachstellen zu suchen. Deaktivieren Sie den Debug-Modus stets, sobald die Fehlersuche abgeschlossen ist. Auf Staging-Umgebungen kann WP_DEBUG dauerhaft aktiv bleiben, da sie nicht öffentlich zugänglich sind.