In einer perfekten Welt würdest du niemals ein einziges Problem haben, das eine Fehlerbehebung erfordert. Aber in der realen Welt wirst du mit ziemlicher Sicherheit auf deiner WordPress Webseite auf Probleme stoßen, die einen Blick unter die Haube erfordern.
Um dir dabei zu helfen, enthält WordPress seinen eigenen eingebauten Debug-Modus, und du kannst auch nützliche Tools von Drittanbietern finden, die dir beim Debuggen von WordPress helfen.
In diesem Beitrag gehen wir auf den eingebauten WordPress-Debug-Modus ein und zeigen dir, wie du ihn aktivieren kannst. Dann werden wir auch einige der anderen Möglichkeiten vorstellen, wie du deine Webseite in WordPress debuggen kannst.
Hier ist alles, was wir behandeln werden:
- Eine Einführung in den WordPress-Debug-Modus und das Debug-Protokoll
- Wie man den WordPress-Debug-Modus aktiviert (drei Methoden)
- Einige andere Möglichkeiten, WordPress zu debuggen
Was macht WP Debug?
Der Kern der WordPress-Software ist in PHP geschrieben, ebenso wie Plugins und Themes.
Wenn du Probleme mit deiner Webseite hast, kann dir der WordPress-Debug-Modus dabei helfen, herauszufinden, was schief läuft, indem er alle PHP-Fehler, Hinweise und Warnungen anzeigt.
Sobald du den Debug-Modus aktivierst, siehst du immer dann Meldungen wie diese, wenn es ein Problem gibt (auch wenn es keine unmittelbaren Probleme verursacht):
Du kannst dann das Problem beheben oder es deinem Entwickler oder dem Entwickler des Themes/Plugins melden.
Was ist das WordPress-Debug-Protokoll?
Wenn du den WordPress-Debug-Modus selbst aktivierst, siehst du im Moment Meldungen wie im obigen Beispiel auf deiner Webseite – aber diese Meldungen werden nirgends gespeichert.
Wenn du sie speichern möchtest, kannst du auch das WordPress-Debug-Protokoll aktivieren, um all diese Meldungen und Fehler in einer Datei auf deinem Server zu speichern.
Wenn die Aktivierung durch Setzen der Konstante WP_DEBUG_LOG auf true erfolgt, schreibt WordPress alle Meldungen in die folgende Datei:
wp-content/debug.log
Du kannst jedoch auch einen benutzerdefinierten Dateipfad angeben, um das Protokoll an einen anderen Ort auf deinem Server zu schreiben.
Wenn du Probleme im Protokoll speichern, aber nicht öffentlich im HTML deiner Webseiten anzeigen willst (wie im obigen Beispiel-Screenshot), kannst du auch die Konstante WP_DEBUG_DISPLAY verwenden, um den Debug-Modus aktiviert zu lassen, aber keine Meldungen auf deiner Webseite anzuzeigen.
Normalerweise wirst du WP_DEBUG_DISPLAY mit WP_DEBUG_LOG kombinieren wollen.
Wie man den WordPress-Debug-Modus aktiviert
Um den WordPress-Debug-Modus zu aktivieren, hast du mehrere Optionen. Wir werden drei Methoden zur Aktivierung behandeln:
Wie man den WordPress-Debug-Modus in MyKinsta aktiviert
Wenn du deine WordPress-Webseite bei Kinsta hostest, haben wir ein einfaches Tool entwickelt, mit dem du den WordPress-Debug-Modus aktivieren kannst, ohne deine wp-config.php-Datei bearbeiten zu müssen.
Dieses Tool ist praktisch, um den Debug-Modus schnell zu aktivieren und Nachrichten auf deiner Webseite anzuzeigen, aber es erlaubt dir nicht, das WordPress-Debug-Protokoll zu kontrollieren oder ob Nachrichten auf Live-Seiten angezeigt werden sollen oder nicht. Wenn du nur das Debug-Protokoll verwenden möchtest, könntest du die Plugin-Methode im nächsten Abschnitt bevorzugen.
Um anzufangen:
- Öffne dein MyKinsta-Dashboard.
- Wähle die Webseite, auf der du das Debugging aktivieren möchtest, aus der Liste Seiten aus.
- Gehe auf die Registerkarte Werkzeuge im Dashboard dieser Webseite.
- Klicke unter WordPress-Debugging auf Aktivieren.
Du kannst das Tool sowohl in deiner Live- als auch in deiner Staging-Umgebung verwenden. Wann immer es möglich ist, empfehlen wir jedoch, es mit Ihrer Staging-Umgebung zu verwenden, da die Aktivierung des WordPress-Debug-Modus den Besuchern Details über den PHP-Code deiner Webseite anzeigen könnte (was für Besucher verwirrend und auch ein Sicherheitsrisiko ist).
Wenn du fertig bist, kannst du den Debug-Modus deaktivieren, indem du auf die Schaltfläche Deaktivieren in deinem Kinsta-Dashboard klickst:
Wie man ein WordPress-Debug-Plugin benutzt
Wenn du nicht bei Kinsta hostest, kannst du auch kostenlose WordPress-Debug-Plugins finden, die es einfach machen, den Debug-Modus zu aktivieren. Es gibt mehrere Optionen bei WordPress.org, aber wir empfehlen das kostenlose WP-Debugging-Plugin von Andy Fragen.
Sobald du das Plugin installiert und aktiviert hast, beginnt es sofort zu funktionieren. Standardmäßig setzt es die folgenden Konstanten auf true (d.h. es aktiviert die folgenden Funktionen):
WP_DEBUG– aktiviert den Debug-Modus.WP_DEBUG_LOG– speichert Nachrichten in einer Protokolldatei.SCRIPT_DEBUGSAVEQUERIES
Was die letzten beiden Konstanten bewirken, werden wir etwas später in diesem Beitrag behandeln.
Um ein paar Optionen zu konfigurieren, kannst du auf Tools → WP Debugging gehen:
Wenn du fertig bist, stelle sicher, dass du das Plugin deaktivierst, um den Debug-Modus abzuschalten.
Wie man den WordPress-Debug-Modus manuell aktiviert
Schließlich kannst du auch den WordPress-Debug-Modus aktivieren, indem du die Konstanten manuell zu deiner wp-config.php-Datei hinzufügst.
Um zu beginnen, verbinde dich per FTP mit deinem Server und bearbeite die Datei wp-config.php. Standardmäßig befindet sich diese Datei im Stammordner deiner Webseite (es sei denn, du hast sie aus Sicherheitsgründen verschoben).
Um nur den grundlegenden WordPress-Debug-Modus zu aktivieren, füge den folgenden Codeausschnitt über der Zeile mit der Aufschrift /* That’s all, stop editing! Happy blogging. */:
// Enable WP_DEBUG mode
define( 'WP_DEBUG', true );
Du kannst auch einige der folgenden Konstanten nach deinen Präferenzen verwenden:
// Enable Debug logging to the /wp-content/debug.log file
define( 'WP_DEBUG_LOG', true );
// Disable display of errors and warnings
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
Wenn du fertig bist, kannst du entweder die Konstanten auf „false“ setzen oder einfach das Snippet entfernen, um den Debug-Modus zu deaktivieren.
Stelle sicher, dass der Debug-Modus in WordPress deaktiviert wird, wenn du fertig bist
Der Debug-Modus ist nützlich, wenn du versuchst, Probleme mit WordPress zu beheben, aber du solltest ihn nicht rund um die Uhr aktiviert lassen, da er Text aus deinem PHP-Code für Webseiten-Besucher aufdecken kann.
Wir haben dies oben erwähnt – aber dies ist nur eine Erinnerung daran, den Debug-Modus immer zu deaktivieren, wenn du mit der Fehlersuche fertig bist.
Andere Wege, WordPress zu debuggen
Neben dem eingebauten Debug-Tool, das wir oben vorgestellt haben, gibt es mehrere andere eingebaute Tools und Tools von Drittanbietern, die dir beim Debuggen deiner Webseite in WordPress helfen.
Skript-Debugging
SCRIPT_DEBUG ist eine weitere eingebaute Konstante, die WordPress dazu zwingt, die Dev-Versionen der CSS- und JavaScript-Kerndateien zu verwenden, anstatt der Minified-Versionen, die es normalerweise lädt.
Dies kann hilfreich sein, wenn du Änderungen an den eingebauten .js- oder .css-Dateien testen möchtest.
Um SCRIPT_DEBUG zu aktivieren, kannst du entweder:
- Das kostenlose WP-Debugging-Plugin von oben verwenden, das es standardmäßig aktiviert.
- Die folgende Konstante zu deiner wp-config.php-Datei hinzufügen –
define( 'SCRIPT_DEBUG', true );
Debugging von Datenbankabfragen
Wenn du Probleme mit der Datenbank deiner Webseite hast, kannst du die Protokollierung von Datenbankabfragen aktivieren, indem du die Konstante SAVEQUERIES zum Nachverfolgen verwendest:
- Jede Datenbankabfrage.
- Die Funktion, die die Datenbankabfrage aufgerufen hat.
- Wie lange die Abfrage gedauert hat.
Um die Abfrageprotokollierung zu aktivieren, kannst du entweder
- Das kostenlose WP-Debugging-Plugin von oben verwenden, das es standardmäßig aktiviert.
- Füge die folgende Konstante zu deiner wp-config.php-Datei hinzu –
define( 'SAVEQUERIES', true );
Hinweis: dies wird die Leistung deiner Webseite beeinflussen, also versuche, es wann immer möglich auf einer Staging-Seite zu verwenden und deaktiviere es, sobald du fertig bist.
Query Monitor Plugin
Das Query Monitor-Plugin ist ein kostenloses Plugin, das für die Fehlersuche in verschiedenen Bereichen von WordPress hilfreich ist:
- Datenbank-Abfragen.
- PHP-Fehler.
- Hooks und Aktionen.
- Block-Editor-Blöcke.
- Eingereihte Skripte und Stylesheets.
- HTTP-API-Aufrufe.
- Benutzer-Fähigkeiten.
Insgesamt ist es eines der besten WordPress-Debugging-Tools, die du finden kannst, weshalb es in über 320 Rezensionen fast eine perfekte 5-Sterne-Bewertung erhalten hat.
Sobald du das Plugin installiert und aktiviert hast, bekommst du einige neue Optionen in der WordPress-Symbolleiste, die Debug-Informationen anzeigen. Wenn du auf diese Optionen klickst, öffnet sich ein neues Query Monitor-Feld, das dir mehr Informationen bietet:
Für eine detailliertere Betrachtung haben wir einen ganzen Beitrag über die Verwendung des Query-Monitor-Plugins.
New Relic
New Relic ist ein erstklassiges Tool zur Analyse und Fehlerbehebung der Leistung deiner Webseite. Es kann dir helfen, Engpässe und Probleme zu entdecken, die die Leistung deiner Webseite beeinträchtigen.
Kinsta enthält bereits das integrierte APM-Tool. Du kannst New Relic jedoch auch im MyKinsa Dashboard verwenden, sofern du eine eigene Lizenz hast.
Server-Protokolle
Schließlich können deine Server-Protokolle auch ein nützliches Werkzeug zur Fehlersuche in WordPress sein.
Wenn du bei Kinsta hostest, kannst du alle deine Server-Logs über die Registerkarte Logs im Dashboard einer Webseite einsehen:
Wenn du woanders hostest, brauchst du die Dokumentation deines Hosts, um zu erfahren, wo du auf deine Server-Logs zugreifen kannst.
Zusammenfassung
Wenn du WordPress debuggen musst, bietet der integrierte WordPress-Debug-Modus eine nützliche Möglichkeit, PHP-Fehler und Hinweise anzuzeigen.
Wenn du bei Kinsta hostest, kannst du ihn direkt von deinem Dashboard aus aktivieren. Andernfalls kannst du es mit Plugins aktivieren oder indem du Code-Snippets zur wp-config.php-Datei deiner Webseite hinzufügst.
Wenn du weitere Hilfe benötigst, kannst du auch andere eingebaute Werkzeuge oder Werkzeuge von Drittanbietern wie New Relic (deine eigene Lizenz ist erforderlich) und das kostenlose Plugin Query Monitor verwenden.
Hast du weitere Fragen zum Debuggen von WordPress? Hinterlasse einen Kommentar und lasst es uns wissen!
Jon ist Chief Operating Officer bei Kinsta und arbeitet täglich mit den Teams von Kinsta in den Bereichen Vertrieb, Kundendienst und technischer Support zusammen. Jon ist ein Familienmensch. Wenn er nicht gerade fieberhaft auf die Tasten seines Laptops tippt, hilft er normalerweise einem seiner Kinder beim Reparieren eines Fahrrads oder richtet Netflix für ein ungeduldiges Vorschulkind ein.
Schreibe einen Kommentar