Die Aktivierung des Debug-Modus erfordert die Bearbeitung einer Datei in deiner WordPress-Installation. Es ist einfach, sollte jedoch mit Vorsicht durchgeführt werden, um keine Schäden an der Website zu verursachen. Im Folgenden findest du eine Schritt-für-Schritt-Anleitung, wie du es richtig machst.
Nach der Aktivierung kannst du Fehler protokollieren, sie vor Besuchern verbergen und steuern, wie WordPress Debug-Informationen verarbeitet. Dies ist besonders wichtig auf Live-Websites, wo Fehler zwar aufgezeichnet, aber nicht öffentlich angezeigt werden sollen.
Die Datei wp-config.php finden
Der erste Schritt zur Aktivierung des Debug-Modus besteht darin, die Datei wp-config.php zu finden. Diese Datei befindet sich im Hauptverzeichnis deiner WordPress-Installation, im selben Ordner wie wp-content, wp-includes und wp-admin. Du kannst darauf über ein FTP-Programm, den Dateimanager deines Hosting-Panels oder direkt auf einem Entwicklungsserver zugreifen.
Es wird empfohlen, eine Sicherungskopie dieser Datei zu erstellen, bevor Änderungen vorgenommen werden. Schon ein fehlendes Zeichen kann deine Website unbrauchbar machen. Mit einer Sicherung kannst du sie sofort wiederherstellen. Sobald du die Datei gefunden hast, öffne sie in einem Texteditor und bereite dich darauf vor, die Konfiguration anzupassen.
WP_DEBUG aktivieren
In der Datei wp-config.php scrolle, bis du eine Zeile findest, die so aussieht: define( 'WP_DEBUG', false );. Diese Zeile steuert, ob der Debug-Modus aktiv ist oder nicht. Standardmäßig ist die Debugging-Funktion in WordPress aus Sicherheits- und Performancegründen deaktiviert. Um den Debug-Modus zu aktivieren, musst du den Wert einfach von false auf true ändern.
Die richtige Zeile sollte so aussehen: define( 'WP_DEBUG', true );. Nachdem du die Datei gespeichert hast, beginnt WordPress sofort damit, PHP-Warnungen, Hinweise und Fehlermeldungen auf deiner gesamten Website anzuzeigen. Auf diese Weise kannst du problematische Plugins, Themes oder benutzerdefinierten Code identifizieren.
WP_DEBUG_LOG zur Fehlerprotokollierung verwenden
Auch wenn die Anzeige von Fehlern auf dem Bildschirm während der Entwicklung nützlich ist, ist sie nicht immer praktisch. Für eine längerfristige Überwachung kannst du WP_DEBUG_LOG aktivieren. Füge dazu folgende Zeile direkt unterhalb der WP_DEBUG-Konstante ein: define( 'WP_DEBUG_LOG', true );. Dadurch werden alle Fehler in einer Datei debug.log im Verzeichnis wp-content gespeichert.
Eine Protokolldatei ist besonders hilfreich, wenn du Fehler verfolgen musst, die zu bestimmten Zeiten auftreten oder die sich nicht direkt auf dem Bildschirm reproduzieren lassen. Sie ermöglicht es dir außerdem, die Datei mit Entwicklern oder Support-Teams zu teilen, ohne ihnen direkten Zugriff auf deine Website zu geben.
Fehler vor Besuchern verbergen
Wenn deine WordPress-Seite live ist, möchtest du wahrscheinlich nicht, dass Besucher rohe Fehlermeldungen sehen. In diesem Fall kannst du eine weitere Einstellung hinzufügen, um die Anzeige im Frontend zu deaktivieren: define( 'WP_DEBUG_DISPLAY', false );. Dadurch werden Fehler zwar weiterhin protokolliert, aber nicht für Nutzer sichtbar gemacht.
Zusätzlich kannst du @ini_set( 'display_errors', 0 ); hinzufügen, um dieses Verhalten zu verstärken. Diese Kombination sorgt dafür, dass deine Website professionell und sicher bleibt, während die notwendigen Informationen im Debug-Log für Administratoren und Entwickler verfügbar sind.
Erweitertes Debugging mit SCRIPT_DEBUG
Für Entwickler, die mit JavaScript und CSS arbeiten, bietet WordPress eine zusätzliche Konstante: define( 'SCRIPT_DEBUG', true );. Standardmäßig lädt WordPress minimierte Versionen von Skripten und Stylesheets. Wenn du das Skript-Debugging aktivierst, lädt WordPress die vollständigen, nicht minimierten Versionen, die leichter zu untersuchen und zu debuggen sind.
Diese Einstellung ist besonders wertvoll, wenn du Themes oder Plugins entwickelst und das Verhalten von Skripten und Styles verfolgen musst. Für normale Nutzer ist sie meist nicht notwendig, kann aber für Entwickler beim Beheben von Frontend-Problemen einen großen Unterschied machen.
Zusammenfassend ist die Aktivierung des Debug-Modus in WordPress eine einfache, aber äußerst wirkungsvolle Methode zur Fehlerdiagnose und -wartung deiner Website. Durch die Bearbeitung der Datei wp-config.php kannst du Fehler anzeigen, sie protokollieren und dein Erscheinungsbild professionell halten – auch bei Problemen. Richtig eingesetzt, ist der Debug-Modus eines der wichtigsten Werkzeuge, um WordPress sicher, stabil und entwicklerfreundlich zu halten.
