Віддалені запити за допомогою wp_remote_get
Якщо ви читали будь-яку з моїх попередніх публікацій про отримання віддалених файлів, то ви знаєте, що старі звички важко вмирають, оскільки я часто використовую file_get_contentsзамість wp_remote_get.
Тому, як і під час ведення блогу, я подумав, що було б корисно поділитися простим прикладом того, як використовувати wp_remote_getйого у своїй повсякденній роботі.
Повідомлення нижче є лише фрагментом того, як ним користуватися. Тобто, він не показуватиме, як розроблено, скажімо, клас навколо нього чи інтерфейс користувача, який дозволяє користувачам завантажувати файл. Але цього має бути достатньо, щоб почати роботу.
І я розповім, як використовувати документацію API і розуміти, як використовувати її під час використання такої функції.
Хоча я не завжди користуюся API WordPress (зазвичай це пов’язано з тим, що, знову ж таки, старі звички залишаються в минулому або тому, що я не знаю про функцію), я намагаюся.
І я твердо переконаний, що якщо ви працюєте в конкретному середовищі програми, і ця програма надає для чогось API, тоді ви повинні використовувати її.
Як читати документи
Якщо ви знайомі з тим, як використовувати документацію, можете пропустити цей розділ.
З огляду на це, ось що wp_remote_getговорить документація:
Отримайте необроблену відповідь із запиту HTTP за допомогою методу GET . Результати включають HTTP-заголовки та вміст.
Ви можете прочитати більше на цій сторінці в Кодексі та на цій сторінці в Ресурсах для розробників. Але перш ніж фактично використовувати функцію, важливо зрозуміти, що вона приймає і що повертає.
І функція приймає два параметри:
- URL-адресу, на яку надсилається запит,
- набір аргументів, необхідних для запиту (що виходить за рамки цієї публікації).
А wp_remote_get повертає змішані результати на основі результату запиту. Відповідно до ресурсів розробника:
(WP_Error|масив) Відповідь або WP_Error у разі помилки.
На цьому етапі ми знаємо, що функція робить, що вона приймає і що повертає. Отже, у нас є достатньо, щоб продовжити створення простого прикладу.
Використання wp_remote_get
З усім вищевикладеним на місці, ось простий приклад того, як отримати файл із заданої URL-адреси. Я припускаю, що URL-адреса знаходиться на вашому локальному сервері (оскільки я не хочу вдаватися до запитів інформації з інших серверів у цій публікації), тому домен як TLD є локальним.
Коментарі повинні пояснити, що відбувається, але після цього я висловлю ще кілька думок.
Зверніть увагу на найважливіші речі:
- Перевірте заголовки, щоб переконатися, що вони встановлені. Якщо ні, то немає потреби продовжувати захоплювати тіло файлу.
- Якщо виникла помилка, ми маємо її акуратно виправити.
- Якщо все інше перевірено, ми готові записати файл на диск. Для цього я використовую файлові функції PHP. Це трохи виходить за рамки публікації, але має бути легко зрозумілим, якщо ви вивчите посилання нижче.
Зрештою, використання wp_remote_getдає вам багато функцій, загорнутих у просту у використанні функцію.