Wann brauchst du den Debug-Modus?

Wenn deine WordPress-Website Probleme macht – weisse Seite, Fehlermeldungen, unerwartetes Verhalten – ist der Debug-Modus dein wichtigstes Diagnosewerkzeug. Er zeigt versteckte PHP-Fehler, Warnungen und Hinweise an, die im Normalbetrieb unterdrückt werden. Ohne den Debug-Modus fliegst du blind.

Debug-Modus aktivieren

Die Aktivierung erfolgt in der wp-config.php im Hauptverzeichnis deiner WordPress-Installation:

  • Suche die Zeile define(WP_DEBUG, false)
  • Ersetze sie durch: define(WP_DEBUG, true)
  • Zusaetzlich einfügen: define(WP_DEBUG_LOG, true)
  • Zusaetzlich einfügen: define(WP_DEBUG_DISPLAY, false)

WP_DEBUG_LOG schreibt alle Fehler in die Datei wp-content/debug.log. WP_DEBUG_DISPLAY verhindert die Anzeige von Fehlern im Frontend – wichtig für Live-Websites.

Debug-Log analysieren

Die debug.log-Datei befindet sich im wp-content-Ordner:

  • Zugriff per FTP oder Dateimanager im Hosting-Control-Panel
  • Jede Zeile enthaelt: Zeitstempel, Fehlerart, betroffene Datei und Zeile
  • PHP Fatal Errors: Kritische Fehler, die zum Absturz fuehren
  • PHP Warnings: Hinweise auf Probleme, die behoben werden sollten
  • PHP Deprecated: Veraltete Funktionen, die in zukuenftigen Versionen entfernt werden
  • PHP Notices: Kleinere Hinweise, meist unkritisch

Query Monitor Plugin

Für tiefere Analysen ist Query Monitor unverzichtbar:

  • Datenbank-Queries: Zeigt alle SQL-Abfragen mit Laufzeit und verursachendem Plugin
  • Hook-Analyse: Welche WordPress-Hooks werden aufgerufen
  • HTTP-API-Aufrufe: Externe API-Calls mit Antwortzeiten
  • Transients: Status und Inhalt der Cache-Eintraege
  • Conditionals: Welche Template-Conditions treffen zu

Query Monitor zeigt seine Ergebnisse in einer Toolbar am Seitenende – nur für eingeloggte Administratoren sichtbar.

Haeufige Fehler und Loesungen

  • Headers already sent: Leerzeichen oder Ausgaben vor dem öffnenden PHP-Tag in einer Datei
  • Out of memory: PHP Memory Limit erhoehen via wp-config.php: define(WP_MEMORY_LIMIT, 256M)
  • Deprecated warnings: Plugin oder Theme aktualisieren, das die veraltete Funktion nutzt
  • Undefined index/variable: Programmierfehler im Theme oder Plugin – Entwickler informieren

Debug-Modus auf Live-Websites

Wichtige Sicherheitshinweise:

  • Niemals WP_DEBUG_DISPLAY auf true bei Live-Websites setzen
  • Die debug.log kann sensible Informationen enthalten – schuetzen oder regelmaessig löschen
  • Begrenze den Zugriff auf debug.log per .htaccess
  • Deaktiviere den Debug-Modus nach Abschluss der Fehleranalyse

Debug-Modus deaktivieren

Nach der Fehlersuche nicht vergessen:

  • Setze alle drei Debug-Konstanten zurueck auf false
  • Loesche die debug.log-Datei
  • Pruefe, dass keine Debug-Informationen mehr im Frontend sichtbar sind

Unser Fazit

Der Debug-Modus ist das wichtigste Werkzeug für WordPress-Fehlersuche. Mit wp-config.php und dem Query Monitor-Plugin findest du Probleme schnell und gezielt. Aktiviere ihn bei Problemen, analysiere die Logs, behebe den Fehler – und deaktiviere ihn dann wieder.