Letztes Mal sind wir durch folgendes gegangen:

1. Debug-Konstanten konfigurieren,
2. Suchen einer Fehlerprotokolldatei,
3. verstehen, wie man die Protokolldatei liest,
4. Stack-Traces verstehen
5. verstehen, wie man den Stack liest

So schön das auch ist, es ist dennoch wichtig zu verstehen, wie Daten aus programmatischer Sicht in das Fehlerprotokoll geschrieben werden. Das heißt; Es ist eine Sache, wenn Ihre Arbeit Fehler, Warnungen oder Hinweise auslöst.

Es ist eine andere Sache, wenn Sie verstehen möchten, wie Sie Informationen in die Datei schreiben, um sie manuell zu durchsuchen und zu debuggen.

In diesem Beitrag werden wir genau das weiter tun, um unser Verständnis von WordPress-Fehlerprotokollen zu verbessern.

WordPress-Fehlerprotokolle verstehen, Teil 2

Was bringt es überhaupt, in das Fehlerprotokoll zu schreiben? Ich meine, ist es überhaupt Teil des Debugging-Prozesses?

Aus dem vorherigen Beitrag :

Aber was ist, wenn wir etwas ausgeben wollen, um einen Einblick zu bekommen, was WordPress oder PHP sieht? Das ist auch nützlich.

Wenn Programmierer an das Debuggen denken, denken viele von ihnen daran, einen echten Debugger (dh ein Stück Software) zu verwenden, Haltepunkte zu setzen und den Code schrittweise zu durchlaufen, um den Wert von Variablen zu beobachten, während das Programm ausgeführt wird.

Wir werden zu diesem Punkt kommen, aber bevor wir dies tun, werfen wir einen Blick darauf, wie wir selbst in das Fehlerprotokoll schreiben können, um uns einen Einblick in die Leistung unserer Arbeit zu geben.

Schließlich ist es eine Sache, wenn unsere Arbeit Warnungen, Fehler und Hinweise auslöst. Es ist eine andere, wenn es Informationen gibt, die wir sehen möchten. Und hier kommt das Schreiben in das Fehlerprotokoll ins Spiel.

PHP-Funktionen verstehen

Um in das Fehlerprotokoll zu schreiben, ist es wichtig, zwei PHP-Funktionen zu verstehen:

1. Fehlerprotokoll
2. print_r

Beachten Sie in Bezug auf die error_log-Funktion, dass ihr Zweck darin besteht:

Senden Sie eine Fehlermeldung an die definierten Fehlerbehandlungsroutinen

In den meisten Fällen ist dies so eingerichtet, dass es über die standardmäßige WordPress- und PHP-Konfiguration für uns in die Protokolldatei schreibt. Aber es gehört noch mehr dazu, weil wir oft die Werte von Variablen, Arrays, Objekten und so weiter ausgeben wollen.

Zu diesem Zweck müssen Sie print_r in Verbindung mit error_log verwenden können. print_r macht folgendes:

Druckt menschenlesbare Informationen über eine Variable

Und wenn Sie das Handbuch lesen, werden Sie feststellen, dass es zwei Argumente benötigt, von denen das zweite auf wahr gesetzt werden sollte, wenn Sie möchten, dass das Ergebnis einer Funktion in die Protokolldatei gedruckt wird.

Genauer gesagt, wie es im Handbuch heißt:

Wenn Sie die Ausgabe von print_r() erfassen möchten, verwenden Sie den returnParameter. Wenn dieser Parameter auf gesetzt ist TRUE, gibt print_r() die Informationen zurück, anstatt sie zu drucken.

Die allgemeine Idee, den Wert eines Arrays, sagen wir $exampleArray, zu schreiben, würde also ungefähr so ​​​​aussehen :

Aber wie sieht es im Kontext von WordPress aus?

Schreiben von Werten in das Fehlerprotokoll in WordPress

Das Obige skizziert also die in PHP integrierten Funktionen, die wir benötigen, aber wie sieht das im Kontext der WordPress-Entwicklung aus?

Nehmen wir dazu an, dass wir eine Version des Registrierungsmusters implementiert haben. In unserer Implementierung des Musters haben wir auch eine Methode namens start, die wir aufrufen können, sobald alle unsere Objekte zur Registrierung hinzugefügt wurden.

Es kann etwa so aussehen :

Nun, was die Implementierung betrifft, ist dies einfach. Aber was ist, wenn wir sehen wollen, welche Objekte bei jeder Iteration der Schleife aufgerufen werden?

Die Idee dahinter ist, dass wir in der Lage sind, die gespeicherten Objekte zu durchlaufen und für jedes von ihnen eine Methode aufzurufen. Dies basiert auf der Idee, dass für jedes der Objekte eine Methode verfügbar ist (die durch eine Schnittstelle erzwungen werden kann ).

Das wirft zunächst eine Frage auf: Warum wollen wir das tun? Aufgrund der Natur des WordPress-Ereignisverwaltungssystems möchten wir vielleicht sicherstellen, dass jedes Objekt, von dem wir erwarten, dass es ausgelöst wird, auch ausgelöst wird.

Zweitens, wie können wir sehen, welche Objekte aufgerufen werden? Hier kommt das Schreiben in das Fehlerprotokoll ins Spiel. Unter Verwendung der oben beschriebenen Methoden wäre eine Möglichkeit, dies zu tun, die folgende :

Dies führt zu folgender Ausgabe:

Hier können Sie das Objekt sehen; sein Namespace, seine Eigenschaftswerte (einschließlich ob die Eigenschaften privat, geschützt, öffentlich usw. sind).

Von dort aus können Sie dann ein wenig debuggen, wenn die Ausgabe das ist, was Sie nicht erwartet haben, oder Sie können dies verwenden, um zu überprüfen, ob Ihr Code das tut, was Sie erwarten.

Dies ist jedoch nur ein Beispiel. Sie könnten jedoch die Werte der $storage- Variablen ausgeben, bevor Sie überhaupt die Schleife durchlaufen. Diese Wahl liegt wirklich bei Ihnen und dem, was Sie erreichen möchten.

Verwenden der installierten Plugins

An dieser Stelle haben wir die grundlegenden Aspekte des Debuggens von Code durch die Verwendung von Fehlerprotokollen behandelt.

Jetzt müssen wir unsere Aufmerksamkeit jedoch auf die Plugins richten, die vor ein paar Beiträgen besprochen wurden. Danach werden wir uns schließlich zu Xdebug hocharbeiten.

Aber als nächstes schauen wir uns die Tools an, die uns innerhalb von WordPress selbst zur Verfügung stehen.