Описание функции wp_remote_head()
Функция wp_remote_head() отправляет HTTP-запрос с методом HEAD к указанному URL и возвращает результаты запроса. Это может быть полезно для проверки доступности ресурса и получения метаинформации без загрузки полного содержимого страницы.
Функция позволяет получить заголовки ответа от сервера, что может быть полезно в различных сценариях, таких как проверка состояния URL или получения информации о типе содержимого
Параметры
$url
Тип: string
Обязательный: Да
Описание: URL для отправки запроса HEAD
Возможные значения:
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив дополнительных параметров для настройки запроса
Возможные значения:
timeout: Время ожидания запроса в секундах (по умолчанию 5)
headers: Массив заголовков для отправки с запросом
sslverify: Проверка SSL (true/false, по умолчанию true)
Возвращаемое значение
Тип: array|WP_Error
Описание: Массив с результатами запроса или объект WP_Error в случае ошибки
Возможные значения:
• Массив с заголовками ответа и статусом при успешном выполнении
• WP_Error в случае ошибок при выполнении запроса
Примеры использования
Отправка запроса HEAD и вывод кода ответа
$response = wp_remote_head('https://example.com');
if (is_wp_error($response)) {
echo 'Ошибка: ' . $response->get_error_message();
} else {
echo 'Статус: ' . wp_remote_retrieve_response_code($response);
}
Выводит статус ответа от сервера
Отправка запроса с увеличенным временем ожидания и отключенной проверкой SSL
$args = array(
'timeout' => 10,
'sslverify' => false
);
$response = wp_remote_head('https://example.com', $args);
Используйте с осторожностью
Проверка на ошибки при выполнении запроса
$response = wp_remote_head('https://invalid-url.com');
if (is_wp_error($response)) {
echo 'Ошибка: ' . $response->get_error_message();
}
Выводит сообщение об ошибке, если запрос не удался
Безопасность
Валидация входных данных: Функция автоматически проверяет корректность URL
Санитизация: Параметры очищаются перед использованием
Рекомендации: При выводе данных используйте esc_html() для предотвращения XSS
— Связанные функции
Отправляет HTTP GET запрос к заданному URL
Отправляет HTTP POST запрос к заданному URL
— Примечания
– Ограничения
Не поддерживает редиректы, если URL перенаправляет, нужно использовать wp_remote_get()
– Частые проблемы
- Ошибки соединения при недоступных URL
- Некорректные результаты при неверных параметрах
