Функция WP_REMOTE_RETRIEVE_HEADER() в WordPress

Функция wp_remote_retrieve_header() позволяет получить значение заголовка из ответов на HTTP-запросы. Она была добавлена в версии WordPress 2.7.0 и не имеет хуков.

Возвращаемые значения

Функция возвращает:

• Строку или массив: Если заголовок найден, то возвращается его значение. Если заголовков с одинаковым именем несколько, возвращается массив значений.
• Пустую строку: Если передан неправильный параметр или если заголовок не существует.

Использование

Сигнатура функции

wp_remote_retrieve_header( $response, $header );

• $response (array|WP_Error) (обязательный): Это ответ HTTP.
• $header (string) (обязательный): Имя заголовка, значение которого нужно получить.

Примеры

Пример 1: Получение даты последнего изменения удаленного файла

В этом примере мы получим дату последнего изменения файла CSS с удаленного сервера.

$response = wp_remote_get( 'http://wp-kama.ru/wp-content/themes/wp-kama/style.min.css' );
$last_modified = wp_remote_retrieve_header( $response, 'last-modified' );

echo $last_modified; // Вывод: Fri, 17 Jun 2016 23:00:35 GMT

Код функции

Вот как выглядит код функции wp_remote_retrieve_header():

function wp_remote_retrieve_header( $response, $header ) {
if ( is_wp_error( $response ) || ! isset( $response['headers'] ) ) {
return '';
}

if ( isset( $response['headers'][ $header ] ) ) {
    return $response['headers'][ $header ];
}

return '';

}

Пояснение к коду

1. Проверка на ошибки: Сначала функция проверяет, есть ли ошибки в ответе (is_wp_error()) или если ответ не содержит заголовков.
2. Получение заголовка: Если заголовок с указанным именем существует, функция возвращает его значение.
3. Возврат пустой строки: Если заголовок не найден, возвращается пустая строка.

Связанные функции

Эта функция может быть полезна вместе с другими функциями WordPress для работы с HTTP-запросами:

• status_header(): Устанавливает заголовок статуса HTTP.
• wp_get_http_headers(): Получает заголовки HTTP.
• wp_remote_get(): Выполняет HTTP GET-запрос.
• wp_remote_post(): Выполняет HTTP POST-запрос.

Эти функции помогут вам более эффективно взаимодействовать с удаленными ресурсами в WordPress.