Если вы читали какие-либо из моих предыдущих сообщений о получении удаленных файлов, то вы знаете, что старые привычки умирают с трудом, поскольку я часто использую file_get_contentsфайлы wp_remote_get.
Поэтому, как и при ведении блога, я подумал, что было бы полезно поделиться простым примером того, как использовать wp_remote_getего в повседневной работе.
Пост ниже – это просто фрагмент того, как его использовать. То есть он не покажет, как спроектировать, скажем, класс вокруг него или пользовательский интерфейс, позволяющий пользователям загружать файл. Но этого должно быть достаточно, чтобы начать работу.
И я расскажу, как использовать документацию по API и понять, как использовать ее при использовании такой функции.
Зачем использовать wp_remote_get?
Хотя я не всегда использую WordPress API (что обычно происходит из-за старых привычек или из-за того, что я не знаю о какой-либо функции), я стараюсь.
И я твердо верю, что если вы работаете в конкретной среде приложения, и это приложение предоставляет API для чего-то, то вы должны его использовать.
Как читать документы
Если вы знакомы с тем, как использовать документацию, вы можете пропустить этот раздел.
С учетом сказанного, вот что wp_remote_getговорится в документации:
Получите необработанный ответ на HTTP-запрос с помощью метода GET. Результаты включают заголовки и содержимое HTTP.
Вы можете прочитать больше на этой странице в Кодексе и на этой странице в Ресурсах для разработчиков. Но прежде чем использовать функцию, важно понять, что она принимает и что возвращает.
И функция принимает два параметра:
- URL-адрес, на который делается запрос,
- набор аргументов, необходимых для запроса (что выходит за рамки этого поста).
И wp_remote_get возвращает смешанные результаты в зависимости от результата запроса. Согласно ресурсам для разработчиков:
(WP_Error|массив) Ответ или WP_Error при сбое.
На данный момент мы знаем, что делает функция, что она принимает и что возвращает. Итак, у нас достаточно, чтобы продолжить настройку простого примера.
Использование wp_remote_get
Имея все вышеперечисленное, вот простой пример того, как получить файл с заданного URL-адреса. Я предполагаю, что URL-адрес находится на вашем локальном сервере (потому что я не хочу вдаваться в запрос информации с других серверов в этом посте), поэтому домен используется как TLD для dot-local.
Комментарии должны объяснить, что случилось, но после этого я предложу еще несколько мыслей.
Обратите внимание на следующие важные моменты:
- Проверьте заголовки, чтобы убедиться, что они установлены. Если нет, то нет необходимости продолжать захват тела файла.
- Если есть ошибка, то нам нужно изящно ее обработать.
- Если все остальное в порядке, то мы готовы записать файл на диск. Для этого я использую файловые функции PHP. Это немного выходит за рамки поста, но должно быть легко понять, если вы изучите ссылки ниже.
В конечном счете, использование wp_remote_getдает вам множество функциональных возможностей, заключенных в простую в использовании функцию.