Website-Suche

So aktivieren Sie den WordPress-Debugging-Modus, um Fehler zu beheben


Wie können Sie den Debugging-Modus in WordPress aktivieren oder weitere Informationen zu WordPress-Fehlern erhalten, die in einem Webbrowser angezeigt werden? Wenn Sie WordPress-Benutzer oder -Entwickler sind und diese Fragen stellen, sind Sie bei der richtigen Ressource gelandet. In dieser Anleitung erfahren Sie, wie Sie die Debugging-Funktionen von WordPress aktivieren.

WordPress bietet mehrere leistungsstarke Debugging-Tools sowohl für Entwickler als auch für Nicht-Programmierer oder allgemeine Benutzer, die Sie mithilfe der verfügbaren Konfigurationsoptionen aktivieren können. Sobald diese Optionen aktiviert sind, können Sie Fehler schnell finden und beheben, indem detaillierte Fehlerinformationen angezeigt werden.

Wir demonstrieren dies anhand des folgenden Fehlers, der beim Einrichten einer Dummy-Site zu Testzwecken aufgetreten ist.

Wenn Sie sich diesen Fehler ansehen, sind ihm nicht viele Informationen beigefügt. Dafür kann es viele Ursachen geben: Der Datenbankserver könnte ausgefallen sein oder die in der Konfigurationsdatei wp-config.php definierten Datenbankverbindungseinstellungen (d. h. Datenbankname, Datenbankbenutzer und Benutzerkennwort) könnten ausgefallen sein falsch liegen.

Wie können wir also weitere Informationen über den oben genannten Fehler erhalten? Die Option WP_DEBUG ist eine permanente globale PHP-Variable, die den „debug“-Modus in ganz WordPress aktiviert und so dazu führt, dass alle PHP-Fehler, Hinweise und Warnungen im Browser angezeigt werden.

Diese „debug“-Funktion wurde in der WordPress-Version 2.3.1 hinzugefügt und ist in wp-config.php konfiguriert – einer der wichtigsten Dateien in Ihrer WordPress-Installation.

Standardmäßig ist die Funktion „debug“ in jeder WordPress-Installation auf false gesetzt. Um WP_DEBUG zu aktivieren, setzen Sie es auf true.

Wechseln Sie zunächst in das Installationsverzeichnis Ihrer Website, z. B. /var/www/html/mysite.com, und öffnen Sie dann die Datei wp-config.php mit Ihrem bevorzugten Texteditor.

cd /var/www/html/mysite.com
sudo vim wp-config.php

Suchen Sie nach dieser Zeile.

define( 'WP_DEBUG',  false );

und ändern Sie es in

define( 'WP_DEBUG', true );

Speichern Sie die Datei und schließen Sie sie.

Jetzt wurde der Debug-Modus ausgelöst. Wenn wir die Seite neu laden, auf der der Fehler angezeigt wurde, können wir die detaillierten Fehlerinformationen sehen, wie im folgenden Screenshot dargestellt.

Es gibt zusätzliche Debug-Optionen, die WP_DEBUG erweitern und besonders nützlich für WordPress-Entwickler sind, die Plugins oder Themes oder andere Komponenten erstellen. Dies sind WP_DEBUG_LOG und WP_DEBUG_DISPLAY.

Wenn die Option WP_DEBUG_LOG auf true gesetzt ist, werden alle Fehler in einer debug.log-Protokolldatei im /wp-content gespeichert / Verzeichnis standardmäßig. Dies ist für die spätere Analyse oder Verarbeitung nützlich.

define( 'WP_DEBUG_LOG', true );

Sie können jedoch eine benutzerdefinierte Protokolldatei angeben, z. B. /var/log/nginx/mysite.com_wp-errors.log:

define( 'WP_DEBUG_LOG', '/var/log/nginx/mysite.com_wp-errors.log' );

Und WP_DEBUG_DISPLAY steuert, ob Debug-Meldungen im HTML von Seiten angezeigt werden oder nicht. Standardmäßig ist es auf true gesetzt. Um es zu deaktivieren, setzen Sie es auf false.

define( 'WP_DEBUG_DISPLAY', false );

Aktivieren Sie den Debug-Modus in WordPress mithilfe des Plugins

Wenn Sie Shared Hosting nutzen, haben Sie wahrscheinlich keinen Zugriff auf das Server-Backend, um Ihre WordPress-Dateien, in diesem Fall die Datei wp-config.php, zu bearbeiten.

Wenn Sie die Einstellungen einfach lieber über das Admin-Dashboard ändern möchten, können Sie ein Plugin namens „Debug Bar“ installieren und verwenden, mit dem Sie WP_DEBUG einfach mit einem einzigen Klick im Admin-Dashboard aktivieren/deaktivieren können Symbolleiste.

Das Killer-Feature dieses Plugins ist, dass es ausfallsicher und clever ist und bei Fehlern automatisch den WP_DEBUG-Modus verlässt.

Referenz: Debuggen in WordPress.