Одна из проблем, которая возникает при написании серии статей об API — или даже о части API — заключается в том, что трудно охватить каждый аспект указанного API, не тратя слишком много времени на углубление в одну часть и одновременно пытаясь не просто скользить по верх каждого API без предоставления достаточно практической информации.
Показательный пример: на протяжении всей последней серии мы рассматривали HTTP-API WordPress. В частности, мы рассмотрели wp_remote_get
и wp_remote_post
и проделали довольно обширную работу с обеими функциями, включая создание примеров проектов.
Дело в том, что в WordPress HTTP API есть много возможностей, которые можно было бы охватить. В будущем мы можем сделать расширенную серию статей о других аспектах API, но сейчас давайте рассмотрим все, что мы рассмотрели в этой серии.
Но во-первых, почему резюме?
Написание относительно длинного ряда о паре функций может охватить много вопросов. Проблема заключается в том, что если в какой-то момент в будущем вам понадобится обратиться к какой-либо части, вы можете не вспомнить, где именно находилась информация.
Или, что еще хуже, вам может потребоваться перебрать значительный объем информации, чтобы найти тот аспект, который вам нужен для продолжения работы.
И конечно, вы всегда можете ссылаться на индекс серии, но для того, чтобы дать своего рода «краткое руководство», я подумал, что было бы полезно обобщить статьи, функции и заметки высокого уровня, касающиеся сегмента API. что мы покрыли на всякий случай, если вам нужна ссылка для вашей работы.
Конечно, обратите внимание, что вы всегда можете просмотреть серию в полном объеме на странице списка сериалов .
Удаленные запросы
Прежде чем мы рассмотрим каждую из функций, помните, что удаленный запрос может быть определен как процесс, с помощью которого один сервер отправляет запрос другому серверу.
Вообще говоря, один сервер может просто отправлять данные на другой сервер, который затем будет что-то делать с ним (будь то сохранение данных, обработка данных и т. Д.), И он может дополнительно отправить ответ обратно.
На высоком уровне это удаленный запрос. Для получения дополнительной информации об этой конкретной идее, обязательно ознакомьтесь с этим постом .
wp_remote_get
wp_remote_get
— это функция, являющаяся частью HTTP-API WordPress, которая отвечает за выполнение запросов GET
.
Функция принимает:
- URL-адрес, на который выполняется запрос
- Массив аргументов для отправки вместе с запросом
Если вы несете основную ответственность за получение информации с сервера, то эту функцию вы захотите использовать.
Во-вторых, если вам нужно больше, чем URL или больший контроль над отправляемым запросом, то вы можете просмотреть эту статью, чтобы просмотреть все аргументы, которые он принимает.
Как это работает?
Далее в этой серии мы создали настоящий плагин, который будет использовать wp_remote_get
чтобы мы могли получить количество подписчиков для данной учетной записи Twitter, а также последний твит, отправленный с указанной учетной записи Twitter.
Основная цель этой статьи и этой демонстрации состояла в том, чтобы дать практический пример того, как использовать wp_remote_get
в «реальном мире». Для получения полного исходного кода для рабочей демонстрации обязательно ознакомьтесь с соответствующей статьей .
Что возвращается?
Поскольку wp_remote_get
ориентирован на получение информации, имеет смысл только ожидать ответа, верно? В заключительной статье, посвященной wp_remote_get
, мы рассмотрели, что именно возвращается с сервера, и как WordPress форматирует его для нашего использования.
Если в ходе вашей работы вам будет трудно точно определить, что именно возвращается с сервера (или почему он не работает должным образом), то эту статью вы должны прочитать.
wp_remote_post
Так же, как wp_remote_get
отвечает за выполнение запросов GET
, wp_remote_post
отвечает за выполнение запросов POST
.
Как и в случае с wp_remote_get
, wp_remote_post
принимает те же аргументы:
- URL, на который делается запрос
- Массив аргументов, которые помогают адаптировать запрос к серверу
Но есть принципиальная разница в назначении этой функции и предыдущей, которая обсуждалась. Разница в том, что происходит, когда запрос завершен.
Точно так же, как wp_remote_get
в основном используется для извлечения данных, wp_remote_post
используется для отправки данных по проводам для обработки — ответ никогда не может быть отправлен обратно.
Для первоначального обзора этой конкретной функции — что она принимает, включая расширенный список аргументов — просмотрите эту статью .
Как это работает?
Как и в случае с wp_remote_get
, мы создали плагин, чтобы продемонстрировать, как wp_remote_post
работает в более широком контексте темы WordPress.
Хотя плагин находится на GitHub для справки, мы рассмотрим всю первую версию плагина в следующей статье . В частности, мы рассмотрим, как сделать запрос к скрипту, ответственному за получение данных $_POST
и как он может отформатировать и вернуть ответ вызывающей стороне.
Что возвращается?
В заключительной статье серии мы завершили плагин с помощью LESS, чтобы придать плагину немного более приятный вид, и округлили плагин, чтобы он фактически сохранял некоторые данные ответов в базе данных, просто чтобы дать представление относительно того, как этого можно достичь.
Вывод
Краткие сообщения — это новая территория — для меня, по крайней мере, — поскольку я исторически позволял своим сериям стоять самостоятельно, но я подумал, что это было бы хорошим справочным материалом, если учесть, что мы охватили так много вопросов в серии.
Повторить:
- Вот полный список статей в серии
- Это ссылка на исходный код
wp_remote_get
- Вот проект
wp_remote_post
на GitHub
С учетом сказанного, дайте мне знать, если вы предпочитаете краткие сообщения или нет. Как я уже упоминал, это то, чем я обычно не занимаюсь, но если это поможет вам, ребята, стать ориентиром, то я буду рад продолжить делать их для будущих серий ».