[How To] Aktivieren Sie WordPress Debug, um Probleme zu beheben (5+ Methoden)

Alles, was Sie über die Aktivierung des WordPress-Debugs wissen müssen

Wenn Ihnen das schon einmal passiert ist, wissen Sie, warum Sie sich mit dem WordPress-Debugging auskennen müssen. Sie probieren das neueste und beste Plugin aus und aktivieren es. Boom!

Ihre Website – tot!

Sie möchten das Plugin deinstallieren, können dies aber nicht, da auch das Backend tot ist.

Oder du bist ein WordPress-Entwickler Sie programmieren ein neues Plugin, wissen aber nicht, warum es nicht wie gewünscht funktioniert. Deshalb ist Debugging eine wichtige Funktion für Programmierer und Webdesigner.

{autotoc}

Wäre es nicht toll, wenn Sie Fehler beim Code-Entwickeln eines neuen Themes oder Plugins leicht finden könnten? WordPress-Debugging ist eine tolle Funktion, mit der Sie Fehler und veraltete Funktionen während der Codeausführung in Ihrer WordPress-Installation leicht finden können.

Dies ist besonders während des Debug-Prozesses praktisch, insbesondere wenn Sie versucht haben, einige experimentelle Funktionen in Ihre Designs oder Plugins zu implementieren.

Standardmäßig blendet die WordPress-Konfiguration PHP-Hinweise beim Laden einer Seite aus. Wenn Sie PHP und die WordPress-API debuggen möchten, müssen Sie einige Anpassungen vornehmen, um das WordPress-Debugging zu aktivieren.

Dies liegt daran, dass die meisten Websites keine PHP-Fehler auf einer Live-Site anzeigen möchten. Die Anzeige solcher WordPress-Debug-Fehler kann gefährlich sein, da die Hinweise Ihren Website-Besuchern wichtige Details über Ihre Website, Ihren Code, Ihre Pfade und andere Informationen preisgeben können, die Hackern Hinweise geben können. Diese Informationen könnten dann dazu verwendet werden, Schadcodes auszunutzen und Ihre Website zu beschädigen.

Literatur-Empfehlungen: 17 Maßnahmen zur Verbesserung der WordPress-Sicherheit

Während der Entwicklungsphase der WP-Kodex empfiehlt Programmierern dringend, das WordPress-Debugging zu aktivieren.

Tatsächlich hilft Ihnen die Aktivierung des WordPress-Debugs auf zwei Arten.

• PHP-Fehler: Es zeigt Fehler an, die durch PHP-Funktionen verursacht werden
• Veraltete Funktionen: Dies sind Funktionen, die möglicherweise in früheren Codeversionen verwendet wurden, aber kürzlich als nicht mehr verwendet markiert wurden. Dies hilft Ihnen, eine Ersatzfunktion zu finden, die Sie stattdessen verwenden können.

In diesem Beitrag werfen wir einen Blick auf verschiedene WordPress-Debugging-Konstanten und wie Sie die Fehlerprotokollierung bei Ihrer Installation oder Website aktivieren …

WordPress-Debug-Einstellungen

1. Aktivieren Sie WordPess Debug mit WP_DEBUG

Die wichtigste PHP-Konstante, die zum Aktivieren des Debug-Modus auf Ihrer Site verwendet werden kann, ist WP_DEBUG.

Standardmäßig ist diese PHP-Konstante auf „false“ gesetzt. Sie wird in Ihrem wp-config.php Datei. 

define( 'WP_DEBUG', false );

Um die Protokollierung zu aktivieren, müssen Sie lediglich WP_DEBUG auf „true“ setzen.

Siehe den Code unten.

define( 'WP_DEBUG', true );

Nachfolgend finden Sie einige Dinge, die Sie beachten müssen, bevor Sie das WordPress-Debug aktivieren.

• Seien Sie vorsichtig, bevor Sie Änderungen an Ihrem wp-config.php Datei, da sie die wichtigste Datei in Ihrer Installation ist. Sie dient zur Konfiguration des Datenbankzugriffs, zur Leistungssteigerung und zur Verbesserung der Sicherheit. Ein kleiner Fehler in der Konfiguration kann dazu führen, dass Ihre Site nicht mehr erreichbar ist.
• Stellen Sie sicher, dass Sie das WordPress-Debugging auf einer Live-Site nicht aktivieren. Wie bereits erwähnt, können wichtige Informationen preisgegeben werden. Außerdem führt das aktivierte WordPress-Debugging zu Leistungsproblemen, da es zu erheblichem Overhead führt.

Lesen empfehlen: So sichern Sie WordPress nativ oder mit einem Plugin

Nachdem wir die Einstellung für das WordPress-Debugging aktiviert haben, müssen wir uns die Ausgabe der Debugging-Befehle ansehen. Dazu aktivieren wir am besten die WordPress-Debugging-Protokolldatei.

Dies kann durch Aktivieren der nächsten Einstellung in wp-config.php.

2. Fehler mit WP_DEBUG_LOG in debug.log protokollieren

Um WordPress-Debugging-Fehler, Hinweise oder andere Ausgaben überprüfen zu können, benötigen wir die WordPress-Debug-Datei. Möglicherweise müssen Sie diese Datei an Ihre Partner oder WordPress-Entwickler senden.

Um die WordPress-Debugging-Protokolldatei zu erstellen, müssen Sie die WordPress-Debug-Protokollierung mit der Einstellung WP_DEBUG_LOG aktivieren. Diese Konstante zwingt WordPress, Debug-Ausgaben in eine Protokolldatei zu schreiben.

Diese PHP-Konstante speichert alle Fehlermeldungen in einer Austestungsprotokoll Datei in der Verzeichniseinstellung „wp-content“, sodass Sie solche Hinweise/Fehler bei Bedarf überprüfen können.

Beachten Sie, dass die Einstellung WP_DEBUG_LOG in Verbindung mit der Konstanten WP_DEBUG funktioniert, d. h. WP_DEBUG muss aktiviert sein, damit die Einstellung WP_DEBUG_LOG wirksam wird.

So aktivieren Sie die Debug-Protokollierung für Austestungsprotokoll Datei. Fügen Sie einfach den folgenden Code zu Ihrer wp-config.php Datei.

define( 'WP_DEBUG_LOG', true);

Sobald es auf „true“ gesetzt ist, werden alle Fehler Ihrer Themen und Plugins verfolgt und im Austestungsprotokoll Datei.

Es besteht auch die Möglichkeit, eine andere Datei festzulegen, indem Sie diese Einstellung leicht variieren. Wenn Sie beispielsweise einen anderen Speicherort oder Namen für die Protokolldatei festlegen möchten, können Sie Folgendes verwenden:

definieren( 'WP_DEBUG_LOG', '/logs/wordpress-errors.log' );

Die obigen Einstellungen haben keinen Einfluss auf die Anzeige im Frontend. Dies kann unabhängig mit der nächsten Einstellung, die wir weiter unten besprechen, festgelegt werden.

3. Anzeigefehler mit WP_DEBUG_DISPLAY aktivieren/deaktivieren

Schauen Sie sich den folgenden Screenshot an. So könnte Ihre Website aussehen, wenn WP_DEBUG_DISPLAY aktiviert ist. Im Wesentlichen handelt es sich dabei um eine Einstellung, die WordPress dazu zwingt, die Fehler im Frontend anzuzeigen, anstatt sie einfach in die Protokolldatei zu schreiben, wie wir in den vorherigen Schritten gesehen haben.

In den meisten Fällen können Sie WP_DEBUG_LOG aktivieren, um alle von Ihren Designs und Plugins verursachten Fehler in einer Protokolldatei zu verfolgen.

Wenn Sie jedoch in einer Entwicklungsumgebung arbeiten, können Sie die PHP-Hinweise oder -Fehler auch im Front-End der Site anzeigen. 

Mit der Konstanten WP_DEBUG_DISPLAY in der Datei wp-config.php können Sie aktivieren/deaktivieren, ob Debug-Meldungen im Frontend Ihrer Site angezeigt werden.

Wenn Sie das WordPress-Debugging aktiviert haben, ist die Anzeige von WordPress-Fehlermeldungen standardmäßig auf „true“ eingestellt. Sie können die Einstellung auf „false“ ändern, um sie auszublenden.

Sie müssen lediglich die folgende Codezeile zu Ihrer Datei wp-config.php hinzufügen.

define( 'WP_DEBUG_DISPLAY', false);

Seien Sie vorsichtig, wenn Sie diese Funktion auf einer Live-Site aktivieren, da dadurch vertrauliche Informationen preisgegeben werden können. Wenn Sie sie vorübergehend aktivieren, vergessen Sie nicht, sie zu deaktivieren, sobald Sie das Problem identifiziert und behoben haben.

4. Aktivieren Sie das Skript-Debugging mit SCRIPT_DEBUG  

Bisher haben wir die Bedeutung des WP_DEBUG-Modus und dessen Aktivierung auf Ihrer Website besprochen. Es gibt eine weitere wichtige PHP-Konstante, die Sie für das Debuggen von WordPress-Skripten aktivieren können: SCRIPT_DEBUG.

Während die Aktivierung von WP_DEBUG alle Fehler aufdeckt, die durch PHP-Funktionen in Ihrem WordPress-Theme und Ihren Plugins verursacht werden, zeigt die Aktivierung von SCRIPT_DEBUG Ihnen, ob es welche gibt Javascript-Entwicklung oder CSS-Fehler.

Tatsächlich wird WordPress beim Debuggen gezwungen, die Entwicklungsversion der Dateien anstelle der minimierten Version zu verwenden, wenn die Konstante SCRIPT_DEBUG aktiviert ist.

Wie Sie vielleicht wissen, WordPress lädt minimierte Versionen von CSS- und JS-Dateien in der Live-Umgebung. Diese minimierten Dateiversionen entfernen alle unnötigen Zeichen in den Dateien, um die Dateigröße zu reduzieren und das Laden der Seite zu beschleunigen.

Lesen empfehlen: 21 Aktionen, um WordPress schneller zu machen

Während das Laden minimierter Dateien äußerst hilfreich für die Benutzererfahrung sein kann und WordPress SEO, es kann für Entwicklungszwecke mühsam sein, insbesondere wenn Sie versuchen, Fehler zu finden und zu beheben.

Indem Sie die Entwicklungsversion der Installation erzwingen, können Sie leicht herausfinden, welche Skripte Konflikte in Ihren CSS- und JS-Kerndateien verursachen. Mithilfe dieser Einstellung in Verbindung mit der Browser-Tools-Konsole können Sie feststellen, wo Javascript-Fehler auftreten, und diese beheben.

Um SCRIPT_DEBUG zu aktivieren, fügen Sie Ihrer Datei wp-config.php den folgenden Code hinzu.

define( 'SCRIPT_DEBUG', true );

5. Aktivieren / Deaktivieren der Protokollierung von Datenbankabfragen

Auch beim Debuggen von Problemen sollten Sie darauf achten, welche Datenbankabfragen ausgeführt werden. Insbesondere bei der Fehlerbehebung und bei Leistungsproblemen sollten Sie genau prüfen, welche Abfragen ausgeführt werden.

Der wp-config.php Die Datei verfügt über eine weitere Einstellung, mit der Sie alle ausgeführten Abfragen protokollieren können. Fügen Sie die folgende Zeile zu w-config hinzu, um das Speichern von Abfragen zu aktivieren. 

definieren('SAVEQUERIES', true);

Sobald Sie diese Option aktivieren, werden alle Abfragen im $wpdb->Abfragen global. Wenn Sie sich nicht sicher sind, was der Wert der Variable ist, können Sie das folgende PHP-Code-Snippet-Skript in eine Datei in WordPress einfügen. Dies gibt den Wert von $wpdb->Abfragen Globale Variable.

Abfragen ); ?>

WordPress-Debug-Plugins

Neben der Protokollierung von Fehlermeldungen müssen Sie möglicherweise auch die Leistung von Abfragen überprüfen oder anderweitig versuchen, die Vorgänge im Hintergrund zu verstehen. Wir empfehlen Ihnen für solche Debugging- oder Fehlerbehebungsmaßnahmen eine Reihe weiterer Plugins und Tools. 

1. Abfrageüberwachung

Abfrage-Monitor ist ein praktisches Plugin, mit dem Sie genau sehen können, was verschiedene Plugins in Ihrer WordPress-Installation tun. Obwohl der Name darauf hindeutet, dass es sich um einen „Abfragemonitor“ handelt, kann dieses Plugin mehr als nur Datenbankabfragen überwachen.

Tatsächlich kann dieses Plugin:

• Debug-Abfragen
• PHP-Fehler überwachen
• Überprüfen Sie Hooks und Aktionen
• HTTP-API-Aufrufe
• Überwachen Sie eingereihte Skripte und Stylesheets 
• Debuggen von AJAX-Aufrufen
• usw.

Sie können die Überwachung auch nach Plugin oder Design eingrenzen, was Ihnen dabei hilft, die Problemquellen einzugrenzen.

2. Debug-Leiste

Dieses Plugin Wird typischerweise von Entwicklern beim Programmieren ihrer Themes oder Plugins verwendet. Das Plugin fügt der WordPress-Adminleiste ein Debug-Menü hinzu, das Abfrage-, Cache- und andere WordPress-Debugging-Informationen anzeigt. 

Das Tolle ist, dass es die oben beschriebenen WordPress-Debug-Einstellungen berücksichtigt.

3. Veraltete Hinweise protokollieren

Dies ist ein weiteres entwicklerorientiertes Plugin. Protokolliert im Wesentlichen, ob Sie veraltete Funktionen, Dateien oder Argumente verwenden, sodass Sie Ihren Code aktualisieren und korrigieren können, um die neuesten Empfehlungen zu verwenden.

Schreiben in das WordPress-Debug-Protokoll

Als Entwickler sollten Sie bei Bedarf Fehlerinformationen zum WordPress-Debug-Protokoll hinzufügen. Dazu benötigen Sie eine spezielle WordPress-Funktion, die Meldungen in das Protokoll ausgibt:

error_log( "This is a log entry" );

Wenn das Debuggen aktiviert ist, erscheint die obige Meldung in der Protokolldatei. Sie können die obige Meldung verwenden, um Ausnahmen oder andere unerwartete Probleme zu protokollieren.

Häufig gestellte Fragen zum WordPress-Debug

Was macht das WordPress-Debugging?

Die verschiedenen WordPress-Debug-Einstellungen ermöglichen die Anzeige von Hinweisen wie Fehlern, veralteten Funktionen oder anderen Fehlerprotokollen, die von Themes, Plugins und anderen WordPress-Funktionen generiert werden. Durch Aktivieren der oben genannten Einstellungen können Sie Fehler in Ihren WordPress-Plugins oder -Themes identifizieren und beheben.

Wo ist das WordPress-Debugging-Protokoll?

Das WordPress-Debugging-Protokoll befindet sich üblicherweise im Stammverzeichnis unter dem Namen debug.log. Mit den oben definierten Einstellungen können Sie den Speicherort des WordPress-Debugging-Protokolls an einen für Sie bequemeren Ort ändern.

Wie deaktiviere ich das Debuggen in WordPress?

Um das Debuggen in WordPress zu deaktivieren, fügen Sie einfach den folgenden Eintrag zu Ihrer Datei wp-config.php hinzu: define( 'WP_DEBUG', false ); Sie können auch die restlichen Einstellungen überprüfen, die wir in diesem Artikel beschreiben.

Was macht WP Debug?

Die WP-Debug-Einstellung in der Datei wp-config.php wird verwendet, um das WordPress-Debugging zu aktivieren oder zu deaktivieren.

Beeinträchtigt das Debuggen von WordPress die Leistung?

Ja, das Debuggen von WordPress beeinträchtigt die Leistung, da es zusätzlichen Aufwand verursacht, einschließlich der Notwendigkeit der Ausgabe in eine Datei. Es wird empfohlen, nach Abschluss des Debuggens alle diese Einstellungen zu deaktivieren. Dies erhöht auch die Sicherheit Ihrer Installation, da die Debug-Protokolle möglicherweise vertrauliche Informationen enthalten.

Zusammenfassung

Wenn Sie eine kurze Zusammenfassung aller besprochenen Punkte wünschen, sehen Sie sich die folgende Beispieldatei wp-config.php mit allen Einstellungen an: 

// WP_DEBUG-Modus aktivieren – zum Deaktivieren einfach „false“ statt „true“ eingeben define( „WP_DEBUG“, true ); // Debug-Protokollierung in der Datei /wp-content/debug.log aktivieren define( „WP_DEBUG_LOG“, true );
// Kommentieren Sie die obige Datei und entfernen Sie die Kommentarzeichen aus der folgenden Datei, um in eine bestimmte Datei zu protokollieren
//define( 'WP_DEBUG_LOG', '/logs/wordpress-errors.log' ); // Anzeige von Fehlern und Warnungen deaktivieren / auf „true“ wechseln, um sie zu aktivieren define( 'WP_DEBUG_DISPLAY', false ); // Entwicklerversionen der JS- und CSS-Kerndateien verwenden (nur erforderlich, wenn Sie diese Kerndateien ändern) define( 'SCRIPT_DEBUG', true );

// Protokollabfragen aktiviert, zum Deaktivieren auf „false“ wechseln
definieren('SAVEQUERIES', true);

Hast du schon mal das WordPress-Debugging aktiviert? Teile deine Meinung mit uns im Kommentarbereich…