Описание функции wp_remote_retrieve_response_message()
Функция wp_remote_retrieve_response_message() предназначена для получения текстового сообщения ответа из результата HTTP-запроса. Это полезно для обработки ответов API и отладки сетевых запросов.
Функция принимает массив результата запроса, полученного с помощью wp_remote_get(), wp_remote_post() или других функций, которые возвращают результаты HTTP-запросов.
Параметры
$response
Тип: array
Обязательный: Да
По умолчанию: null
Описание: Массив результата HTTP-запроса, возвращаемый функциями WP_HTTP
Возможные значения:
code: Код ответа HTTP (например, 200, 404)
message: Текстовое сообщение ответа (например, ‘OK’, ‘Not Found’)
Возвращаемое значение
Тип: string|false
Описание: Возвращает текстовое сообщение ответа или false, если сообщение отсутствует
Возможные значения:
• Текстовое сообщение ответа (например, ‘OK’)
• false, если сообщение отсутствует
Примеры использования
Базовый пример получения сообщения ответа от API
$response = wp_remote_get('https://api.example.com/data');
$message = wp_remote_retrieve_response_message($response);
echo $message; // Выводит 'OK' или другое сообщение
Сообщение будет зависеть от ответа API
Пример обработки ошибок при выполнении запроса
$response = wp_remote_get('https://api.example.com/data');
if (is_wp_error($response)) {
$error_message = $response->get_error_message();
echo 'Ошибка: ' . $error_message;
} else {
$message = wp_remote_retrieve_response_message($response);
echo $message;
}
Проверка на ошибки перед извлечением сообщения
Безопасность
Валидация входных данных: Функция проверяет входной параметр на корректность
Санитизация: Не требуется дополнительная очистка, так как входной параметр должен быть массивом
Рекомендации: Рекомендуется всегда проверять на наличие ошибок перед использованием этой функции
— Связанные функции
Выполняет GET-запрос и возвращает результат
Выполняет POST-запрос и возвращает результат
— Примечания
– Ограничения
Функция не обрабатывает специфические случаи, такие как неполные или поврежденные ответы
– Частые проблемы
- Ошибка при вызове функции с неверным параметром
- Отсутствие сообщения в случае неудачного запроса
