Die Debugging-Funktion in WordPress ist ein unverzichtbares Werkzeug für Entwickler und Administratoren, um Fehler und Probleme auf einer Website zu identifizieren. Das Aktivieren von WP Debug gibt dir detaillierte Einblicke in PHP-Fehler, Datenbankprobleme und andere Warnungen, die im Hintergrund deiner Website auftreten können. In diesem Artikel erfährst du, wie du WP Debug richtig verwendest und das Beste aus dieser Funktion herausholst.
Was ist WP Debug?
WP Debug ist eine eingebaute Funktion in WordPress, die detaillierte Fehlermeldungen und Warnungen anzeigt, wenn ein Problem auf deiner Website auftritt. Sie hilft dir, die Ursache von Problemen zu identifizieren, sei es ein inkompatibles Plugin, ein Fehler im Theme oder ein PHP-Konflikt.
WP Debug aktivieren
Um WP Debug zu aktivieren, öffne die Datei wp-config.php, die im Hauptverzeichnis deiner WordPress-Installation liegt. Suche nach der Zeile:
define(‚WP_DEBUG‘, false);
Ändere den Wert auf true, um Debugging zu aktivieren:
define(‚WP_DEBUG‘, true);
Wenn diese Zeile nicht vorhanden ist, füge sie vor dem Kommentar /* That's all, stop editing! Happy publishing. */ ein.
Fehlerausgabe kontrollieren
Die Aktivierung von WP Debug zeigt standardmäßig alle Fehler direkt auf deiner Website an. Dies ist während der Entwicklung nützlich, kann aber auf einer Live-Website unerwünschte Informationen offenlegen. Verwende stattdessen die Option WP_DEBUG_LOG, um die Fehlermeldungen in eine Log-Datei zu schreiben:
define(‚WP_DEBUG_LOG‘, true);
Die Log-Datei wird im Ordner /wp-content/debug.log erstellt. Hier kannst du die Fehler in Ruhe analysieren, ohne sie Besuchern anzuzeigen.
Wenn du sicherstellen möchtest, dass Fehler nicht auf der Website angezeigt werden, füge folgende Zeile hinzu:
define(‚WP_DEBUG_DISPLAY‘, false);
@ini_set(‚display_errors‘, 0);
Fehler finden und beheben
Nach der Aktivierung von WP Debug kannst du die Fehlermeldungen analysieren, die entweder direkt angezeigt oder in der Log-Datei gespeichert werden. Achte besonders auf:
- PHP-Fehler: Zeigt fehlerhafte Funktionen, Syntaxfehler oder veraltete Befehle an.
- Datenbank-Warnungen: Hinweise auf fehlerhafte Datenbankabfragen oder fehlende Tabellen.
- Theme- und Plugin-Warnungen: Erkennst du an Pfaden, die auf /wp-content/themes/ oder /wp-content/plugins/ verweisen.
Behebe diese Fehler schrittweise:
- Deaktiviere Plugins: Schalte alle Plugins aus und aktiviere sie einzeln, um herauszufinden, welches Plugin das Problem verursacht.
- Teste das Theme: Wechsle zu einem Standard-Theme wie „Twenty Twenty-Three“, um festzustellen, ob das Problem am Theme liegt.
- Prüfe PHP-Version und Anforderungen: Stelle sicher, dass dein Hosting die richtige PHP-Version für deine WordPress-Installation verwendet.
Erweiterte Debugging-Funktionen
Für tiefergehende Fehleranalysen kannst du folgende Optionen in die wp-config.php einfügen:
SAVEQUERIES:
define(‚SAVEQUERIES‘, true);
Diese Option speichert Datenbankabfragen, die du im Anschluss analysieren kannst. Besonders nützlich für Performance-Tuning.
SCRIPT_DEBUG:
define(‚SCRIPT_DEBUG‘, true);
Erzwingt die Verwendung nicht-minifizierter CSS- und JS-Dateien.
WP Debug ist ein mächtiges Werkzeug, das dir hilft, Probleme in WordPress effektiv zu identifizieren und zu beheben. Mit ein wenig Übung und den richtigen Einstellungen kannst du deine Website schnell wieder in den optimalen Zustand bringen.