Jeśli czytałeś którykolwiek z moich poprzednich postów na temat pobierania zdalnych plików, to wiesz, że stare nawyki ciężko umierają, ponieważ często używam file_get_contentszamiast wp_remote_get.
Tak jak robi się to podczas blogowania, pomyślałem, że pomocne będzie udostępnienie prostego przykładu wykorzystania wp_remote_getw codziennej pracy.
Poniższy post to tylko fragment, jak z niego korzystać. Oznacza to, że nie pokaże, jak zaprojektować, powiedzmy, klasę wokół niego ani interfejs użytkownika, który pozwala użytkownikom przesłać plik. Ale to powinno wystarczyć, aby zacząć.
I opiszę, jak wziąć dokumentację API i zrozumieć, jak ją wykorzystać podczas korzystania z takiej funkcji.
Dlaczego warto korzystać z wp_remote_get?
Chociaż nie zawsze używam interfejsu API WordPressa (co zwykle wynika z tego, że przenoszą się stare nawyki lub dlatego, że nie jestem świadomy jakiejś funkcji), próbuję.
I mocno wierzę, że jeśli pracujesz w konkretnym środowisku aplikacji i wspomniana aplikacja dostarcza do czegoś API, powinieneś go użyć.
Jak czytać dokumenty
Jeśli wiesz, jak korzystać z dokumentacji, możesz pominąć tę sekcję.
Mając to na uwadze, oto, co wp_remote_getmówi dokumentacja:
Pobierz surową odpowiedź z żądania HTTP za pomocą metody GET. Wyniki obejmują nagłówki i treść HTTP.
Możesz przeczytać więcej zarówno na tej stronie w Kodeksie, jak i na tej stronie w Zasobach dla programistów. Ale przed faktycznym użyciem funkcji ważne jest, aby zrozumieć, co akceptuje i co zwraca.
A funkcja przyjmuje dwa parametry:
- adres URL, na który kierowane jest żądanie,
- zestaw argumentów wymaganych dla żądania (który jest poza zakresem tego posta).
A wp_remote_get zwraca mieszane wyniki na podstawie wyniku żądania. Zgodnie z zasobami dla programistów:
(WP_Error|array) Odpowiedź lub WP_Error w przypadku niepowodzenia.
W tym momencie wiemy, co funkcja robi, co akceptuje i co zwraca. Mamy więc wystarczająco dużo do zrobienia, jeśli chodzi o stworzenie prostego przykładu.
Korzystanie z wp_remote_get
Mając wszystkie powyższe informacje, oto prosty przykład, jak pobrać plik z podanego adresu URL. Zakładam, że adres URL znajduje się na twoim lokalnym serwerze (ponieważ nie chcę w tym poście prosić o informacje z innych serwerów), dlatego domena jest domeną TLD kropki-local.
Komentarze powinny wyjaśniać, o co chodzi, ale po tym przedstawię kilka dalszych przemyśleń.
Najważniejsze informacje są następujące:
- Sprawdź nagłówki, aby upewnić się, że są ustawione. Jeśli nie, nie ma potrzeby pobierania treści pliku.
- Jeśli pojawi się błąd, musimy poradzić sobie z tym z wdziękiem.
- Jeśli wszystko inne się sprawdzi, jesteśmy gotowi do zapisania pliku na dysku. Aby to zrobić, używam funkcji plików PHP. Jest to trochę poza zakresem postu, ale powinno być łatwe do zrozumienia, jeśli przestudiujesz poniższe linki.
Ostatecznie, używanie wp_remote_getzapewnia wiele funkcji zawartych w łatwej w użyciu funkcji.