Fehler in WordPress debuggen

WordPress lässt sich in der wp-config.php für das Debugging konfigurieren. Um einen Fehler auf einer öffentlichen Website zu untersuchen, schreiben Sie die Details in ein privates Protokoll und lassen die Fehlerausgabe verborgen.

Führen Sie diese Tests am besten in einer Staging-Kopie durch. Zeigen Sie in der Produktion keine Fehler auf dem Bildschirm an: Sie können jedem Besucher Pfade, Abfragen und interne Daten verraten.

Fehler protokollieren, ohne sie anzuzeigen

Legen Sie außerhalb von public_html ein Verzeichnis für Protokolle an, stellen Sie sicher, dass PHP hineinschreiben kann, und geben Sie der Datei die Rechte 0600, wenn das System es zulässt. Fügen Sie diese Zeilen vorübergehend in wp-config.php ein und ersetzen Sie CPANEL_USUARIO. Setzen Sie sie vor das Laden von wp-settings.php, normalerweise vor den Kommentar, der zum Beenden der Bearbeitung auffordert. Wenn eine Konstante schon existiert, ändern Sie ihren Wert, statt sie ein zweites Mal zu deklarieren:

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', false);
define('WP_DEBUG_LOG', '/home/CPANEL_USUARIO/logs/wordpress-debug.log');
@ini_set('display_errors', '0');

Verwenden Sie wp-content/debug.log nicht auf einer öffentlichen Website, es sei denn, der Server blockiert ausdrücklich das Herunterladen. Stellen Sie den Fehler einmal nach, notieren Sie die Uhrzeit und bewahren Sie den ersten Fehler dieser Anfrage mit ein paar Zeilen Kontext auf. Prüfen Sie, dass er keine Passwörter, Tokens oder personenbezogenen Daten enthält, bevor Sie Auszüge weitergeben.

Ich sehe eine weiße Seite

Wenn das WordPress-Protokoll den Fehler nicht erfasst, aktivieren Sie vorübergehend das PHP-Protokoll in cPanel und prüfen Sie dieselbe Uhrzeit, oder bitten Sie den Support, es zu prüfen. Lassen Sie display_errors in der Produktion immer deaktiviert.

Deaktivieren und aufräumen

Stellen Sie am Ende die vorherigen Werte von WP_DEBUG, WP_DEBUG_LOG und WP_DEBUG_DISPLAY wieder her, entfernen Sie die vorübergehende Zeile mit ini_set und löschen Sie die Datei, sobald sie nicht mehr gebraucht wird. Das Debugging darf in der Produktion nicht dauerhaft aktiv bleiben.

Wenn der erwartete Eintrag nicht erscheint

Prüfen Sie, dass Sie die wp-config.php bearbeitet haben, die diese Installation tatsächlich nutzt, und dass PHP in den gewählten Pfad schreiben kann. Verwenden Sie die booleschen Werte true und false ohne Anführungszeichen: Der Text 'false' entspricht nicht dem booleschen Wert falsch.

WP_DEBUG erweitert die Fehlerstufen und kann viele Hinweise erzeugen, die den Fehler nicht verursachen. Verbinden Sie den ersten relevanten Fehler mit der Anfrage und ihrer Uhrzeit. Wenn ein Syntaxfehler auftritt, bevor WordPress diese Optionen lädt, prüfen Sie das PHP-Protokoll des Servers. Der offizielle Debugging-Leitfaden beschreibt den Geltungsbereich jeder Konstante.