Wie prüft man WP_DEBUG Logs in WordPress

WP_DEBUG ist eine WordPress-Konstante, die den Debugging-Modus aktiviert und es Entwicklern ermöglicht, Probleme durch die Protokollierung von Fehlern, Warnungen und Hinweisen zu beheben. In dieser Anleitung wird erklärt, wie Sie WP_DEBUG-Protokolle mit verschiedenen Methoden überprüfen können.

Voraussetzungen

• Zugang zu Ihrer WordPress-Installation (über das Hosting-Kontrollpanel, FTP oder SSH).
• Grundlegendes Verständnis der WordPress-Konfigurationsdateien.
• WP_DEBUG aktiviert in Ihrem wp-konfig.php Datei. Um sie zu aktivieren, fügen Sie die folgenden Zeilen hinzu oder ändern Sie sie:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false ); // Verhindert, dass Fehler auf der Website angezeigt werden

Methode 1: Prüfen von Debug-Protokollen über Dateizugriff

WordPress speichert Debug-Protokolle in einer Datei, wenn WP_DEBUG_LOG aktiviert ist. Standardmäßig befindet sich die Protokolldatei unter wp-content/debug.logSie können jedoch zur besseren Organisation oder Sicherheit einen eigenen Speicherort angeben.

Schritte:

1. Speicherort des Protokolls konfigurieren:

• Für den Standardprotokollspeicherort stellen Sie sicher, dass WP_DEBUG_LOG wird eingestellt auf wahr in wp-konfig.php.
• Für einen benutzerdefinierten Protokollspeicherort fügen Sie die folgende Zeile hinzu oder bearbeiten Sie sie in wp-konfig.php um einen Pfad anzugeben:

define( 'WP_DEBUG_LOG', '/path/to/custom/debug.log' );

• Stellen Sie sicher, dass das Verzeichnis für den Webserver beschreibbar ist (z. B. setzen Sie die Berechtigungen auf 664 oder 666 für die Datei und 755 für das Verzeichnis).

1. Zugriff auf Ihre WordPress-Dateien:

• Verwenden Sie einen FTP-Client (z. B. FileZilla) oder Ihren Hosting-Dateimanager, um auf Ihre WordPress-Installation zuzugreifen.
• Alternativ können Sie für einen schnelleren Zugriff SSH für die Verbindung zu Ihrem Server verwenden.

1. Suchen Sie das Debug-Protokoll:

• Navigieren Sie zum wp-Inhalt Verzeichnis für das Standardprotokoll (wp-content/debug.log) oder zu Ihrem benutzerdefinierten Pfad (z. B., /pfad/zu/angepasst/debug.log).
• Wenn die Protokolldatei nicht vorhanden ist, stellen Sie sicher, dass WP_DEBUG_LOG korrekt konfiguriert ist und eine Aktion auf Ihrer Website auslöst (z. B. das Aktualisieren einer Seite), um Protokolle zu erstellen.

1. Das Logbuch anzeigen:

• Laden Sie die Protokolldatei herunter und öffnen Sie sie mit einem Texteditor (z. B. Notepad++, VS Code).
• Alternativ können Sie SSH verwenden, um die Datei direkt mit einem Befehl wie cat wp-content/debug.log oder cat /pfad/zu/angepasst/debug.log.

1. Interpretieren Sie die Protokolle:

• Die Protokolle enthalten Zeitstempel, Fehlertypen (z. B., PHP-Warnung, PHP-Hinweis) und Details zum Problem, einschließlich der Datei und Zeilennummer, die den Fehler verursachen.

Anmerkungen:

• Benutzerdefinierte Protokollspeicher sind nützlich, wenn wp-Inhalt nicht beschreibbar ist oder zur Organisation von Protokollen in einem sicheren Verzeichnis.
• Stellen Sie sicher, dass benutzerdefinierte Pfade nicht öffentlich zugänglich sind, um zu verhindern, dass sensible Informationen preisgegeben werden.
• Wenn die Protokolldatei groß ist, verwenden Sie Tools wie grep (z.B., grep "PHP-Fehler" wp-content/debug.log), um bestimmte Fehler zu filtern.
• Löschen oder rotieren Sie die Protokolldatei regelmäßig, damit sie nicht zu groß wird.

Methode 2: Verwendung eines Debugging-Plugins

Mehrere WordPress-Plugins vereinfachen den Prozess der Anzeige von Debug-Protokollen ohne direkten Dateizugriff.

Empfohlene Plugins:

• Debug Log Manager: Ein spezielles Plugin zur Aktivierung, Verwaltung und Anzeige von Debug-Protokollen.
• Abfrage-Monitor: Zeigt Debug-Informationen, einschließlich Fehler, direkt im WordPress-Administrationsbereich an.
• Debug-Leiste: Fügt der Verwaltungsleiste ein Debug-Menü hinzu, das Protokolle und andere Debugging-Daten anzeigt.

Schritte:

1. Ein Plugin installieren:

• Gehe zu Plugins > Neu hinzufügen in Ihrem WordPress-Administrationsbereich.
• Suchen Sie das von Ihnen gewählte Debugging-Plugin (z. B. Debug Log Manager) und installieren Sie es.
• Aktivieren Sie das Plugin.

1. Zugriff auf Debug-Protokolle:

• Für Debug Log Managernavigieren Sie zu Werkzeuge > Debug Log Manager im WordPress-Administrationsbereich, um das Debug-Protokoll anzuzeigen, zu filtern oder herunterzuladen. Das Plugin ermöglicht es Ihnen auch, Protokolle zu löschen oder Protokolleinstellungen zu konfigurieren.
• Für Abfrage-MonitorNavigieren Sie zum Menü Query Monitor in der Admin-Leiste, um Fehler und Protokolle anzuzeigen.
• Für Debug-LeisteKlicken Sie auf die Debug-Leiste in der Verwaltungsleiste und sehen Sie sich den Log-Bereich an.

Anmerkungen:

• Plugins können erfordern WP_DEBUG und WP_DEBUG_LOG aktiviert werden.
• Debug Log Manager bietet zusätzliche Funktionen wie die Filterung von Protokollen nach Fehlertyp und die Verwaltung der Größe von Protokolldateien.

Methode 3: Debugging in Echtzeit mit einem Terminal

Fortgeschrittene Benutzer können Debug-Protokolle in Echtzeit über SSH und Terminalbefehle überwachen.

Schritte:

1. Zugriff auf Ihren Server über SSH:

• Stellen Sie mit einem SSH-Client (z. B. PuTTY oder Terminal) eine Verbindung zu Ihrem Server her.

1. Das Debug-Protokoll überwachen:

• Führen Sie den folgenden Befehl aus, um die Protokolldatei in Echtzeit zu sehen:

tail -f wp-content/debug.log

• Für einen benutzerdefinierten Protokollspeicherort verwenden Sie:

tail -f /pfad/zu/angepasst/debug.log

• Die -f stellt sicher, dass neue Protokolleinträge angezeigt werden, wenn sie geschrieben werden.

1. Aktionen auslösen:

• Führen Sie Aktionen auf Ihrer WordPress-Website durch (z. B. Aktualisieren einer Seite, Absenden eines Formulars), um Protokolleinträge zu erzeugen.
• Beobachten Sie das Terminal für eine unmittelbare Rückmeldung.

Anmerkungen:

• Verwenden Sie Strg+C um die Überwachung zu beenden.
• Kombinieren Sie mit grep für die Filterung (z.B., tail -f wp-content/debug.log | grep "PHP-Fehler").

Methode 4: Verwendung von Fehlerprotokollintegrationen

Bei einigen Hosting-Anbietern oder Serverkonfigurationen können Sie WordPress-Debug-Protokolle in Server-Fehlerprotokolle oder Überwachungstools von Drittanbietern integrieren.

Schritte:

1. Hosting-Kontrollzentrum überprüfen:

• Melden Sie sich bei Ihrem Hosting-Kontrollzentrum an.
• Suchen Sie nach einem Fehlerprotokolle oder Protokolle Abschnitt.
• Wenn WP_DEBUG_LOG so konfiguriert ist, dass es in eine für den Server zugängliche Datei schreibt, können hier Fehler auftreten.

1. Integration mit Tools von Drittanbietern:

• Verwenden Sie Tools wie New Relic, Wache, oder Loggly zum Sammeln und Analysieren von WordPress-Debug-Protokollen.
• Konfigurieren Sie diese Tools über Plugins oder durch Anweisung von WP_DEBUG_LOG Ausgabe an ihre APIs.

Anmerkungen:

• Diese Methode erfordert eine zusätzliche Einrichtung und kann mit Kosten für Dienste Dritter verbunden sein.
• Stellen Sie sicher, dass Ihre Hosting-Umgebung benutzerdefinierte Protokollintegrationen unterstützt.

Bewährte Praktiken

• Debugging auf Live-Seiten deaktivieren: Satz WP_DEBUG zu falsch an Produktionsstandorten, um zu verhindern, dass sensible Informationen preisgegeben werden.
• Sichere Protokolldateien: Sicherstellen debug.log nicht öffentlich zugänglich ist (z. B. add von allen ablehnen zu .htaccess für die Protokolldatei).
• Regelmäßige Wartung: Löschen oder archivieren Sie die Protokolle regelmäßig, um Speicherplatz zu sparen.
• Test in Staging: Replizieren Sie Probleme in einer Staging-Umgebung, um eine Störung der Live-Sites zu vermeiden.

Fehlersuche bei allgemeinen Problemen

Nein debug.log Datei:

• Überprüfen Sie WP_DEBUG und WP_DEBUG_LOG werden eingestellt auf wahr in wp-konfig.php.
• Prüfen Sie, ob die wp-Inhalt Verzeichnis oder das benutzerdefinierte Log-Verzeichnis beschreibbar ist (die Berechtigungen sollten 755 für Verzeichnisse und 664 oder 666 für Dateien).

Logs sind leer:

• Stellen Sie sicher, dass Aktionen, die Fehler auslösen, nach der Aktivierung der Fehlersuche durchgeführt werden.
• Prüfen Sie auf Syntaxfehler in wp-konfig.php die eine Protokollierung verhindern könnten.

Große Protokolldateien:

• Verwenden Sie Tools zur Protokollrotation oder Plugins wie Debug Log Manager, um die Dateigröße zu verwalten.
• Filtern Sie Protokolle mit Tools wie grep um sich auf relevante Einträge zu konzentrieren.

Mit diesen Methoden können Sie Probleme auf Ihrer WordPress-Website mithilfe der WP_DEBUG-Protokolle effektiv überwachen und beheben. Wählen Sie die Methode, die am besten zu Ihren technischen Kenntnissen und Ihrer Hosting-Umgebung passt.