Remote-Anfragen mit wp_remote_get
Wenn Sie einen meiner vorherigen Beiträge zum Abrufen von Remote-Dateien gelesen haben, dann wissen Sie, dass alte Gewohnheiten nur schwer sterben, da ich oft file_get_contentseher als wp_remote_get.
Wie man es beim Bloggen tut, dachte ich, es wäre hilfreich, ein einfaches Beispiel für die Verwendung wp_remote_getin Ihrer täglichen Arbeit zu teilen.
Der folgende Beitrag ist nur ein Ausschnitt dessen, wie man es benutzt. Das heißt, es wird nicht gezeigt, wie man beispielsweise eine Klasse um sie herum oder eine Benutzeroberfläche entwirft, die es Benutzern ermöglicht, eine Datei hochzuladen. Aber für den Anfang sollte das reichen.
Und ich werde hinzufügen, wie man die API-Dokumentation umgeht und versteht, wie man sie nutzt, wenn man eine Funktion wie diese verwendet.
Warum wp_remote_get verwenden?
Obwohl ich die WordPress-API nicht immer verwende (was normalerweise daran liegt, dass alte Gewohnheiten übernommen werden oder weil ich eine Funktion nicht kenne), versuche ich es.
Und ich bin fest davon überzeugt, dass Sie es verwenden sollten, wenn Sie in einer bestimmten Umgebung einer Anwendung arbeiten und diese Anwendung eine API für etwas bereitstellt.
So lesen Sie die Dokumente
Wenn Sie mit der Nutzung der Dokumentation vertraut sind, können Sie diesen Abschnitt überspringen.
Vor diesem Hintergrund heißt es in der Dokumentation wp_remote_get:
Rufen Sie die unformatierte Antwort von der HTTP-Anforderung mit der GET- Methode ab. Zu den Ergebnissen gehören HTTP-Header und -Inhalt.
Sie können mehr auf dieser Seite im Codex und auf dieser Seite in den Entwicklerressourcen lesen. Aber bevor Sie die Funktion tatsächlich verwenden, ist es wichtig zu verstehen, was sie akzeptiert und was sie zurückgibt.
Und die Funktion akzeptiert zwei Parameter:
- die URL, an die die Anfrage gestellt wird,
- die Menge an Argumenten, die für die Anfrage erforderlich sind (was außerhalb des Rahmens dieses Beitrags liegt).
Und wp_remote_get gibt basierend auf dem Ergebnis der Anfrage gemischte Ergebnisse zurück. Gemäß den Entwicklerressourcen:
(WP_Error|array) Die Antwort oder WP_Error bei Fehler.
An diesem Punkt wissen wir, was die Funktion tut, was sie akzeptiert und was sie zurückgibt. Wir haben also genug zu tun, um ein einfaches Beispiel zu erstellen.
Mit wp_remote_get
Nachdem alle oben genannten Punkte vorhanden sind, finden Sie hier ein einfaches Beispiel dafür, wie Sie eine Datei von einer bestimmten URL abrufen. Ich gehe davon aus, dass sich die URL auf Ihrem lokalen Server befindet (weil ich in diesem Beitrag nicht darauf eingehen möchte, Informationen von anderen Servern anzufordern), weshalb die Domain als TLD von dot-local.
Die Kommentare sollten erklären, was los ist, aber ich werde danach ein paar weitere Gedanken anbieten.
Die wichtigsten Dinge beachten sind wie folgt:
- Überprüfen Sie die Header, um sicherzustellen, dass sie gesetzt sind. Wenn dies nicht der Fall ist, müssen Sie nicht mit dem Erfassen des Hauptteils der Datei fortfahren.
- Wenn es einen Fehler gibt, dann müssen wir damit elegant umgehen.
- Wenn alles andere klappt, können wir die Datei auf die Festplatte schreiben. Ich verwende dazu die Dateifunktionen von PHP. Es geht etwas über den Rahmen des Beitrags hinaus, sollte aber leicht verständlich sein, wenn Sie die folgenden Links studieren.
Letztendlich wp_remote_getbietet Ihnen die Verwendung eine Menge Funktionalität, verpackt in einer einfach zu bedienenden Funktion.