WP_GET_HTTP_HEADERS() │ WP 1.5.1

Что такое WP_GET_HTTP_HEADERS()?

Функция wp_get_http_headers() позволяет извлечь HTTP-заголовки из указанного URL. Это полезно, когда вы хотите получить информацию о ресурсах, не загружая все данные с веб-страницы.

Используемые функции

• wp_safe_remote_head()
• wp_remote_retrieve_headers()

Возврат значения

Функция возвращает заголовки в виде объекта WpOrgRequestsUtilityCaseInsensitiveDictionary в случае успешного выполнения или false в случае ошибки.

Синтаксис функции

wp_get_http_headers( $url, $deprecated );

Параметры

• $url (string, обязательный) — URL, из которого нужно получить HTTP-заголовки.
• $deprecated (true|false) — не используется в данной версии. По умолчанию: false.

Примеры использования

Пример 1: Получение HTTP-заголовков по URL

Иногда бывает достаточно получить только HTTP-заголовки, а не всю страницу. Получение ответа от сервера обычно занимает меньше времени:

$r = wp_get_http_headers( 'http://wordpress.org' );
print_r( $r );

Этот код выведет такой массив:

Array
(
    [server] => nginx
    [date] => Sun, 02 Nov 2014 20:39:35 GMT
    [content-type] => text/html
    [content-length] => 154
    [connection] => close
    [location] => https://wordpress.org/
)

Пример 2: Обработка GET-запроса

Можно отправить GET-запрос и получить только заголовки. Это поможет нам взаимодействовать с удалённым сервером. Например, если нам нужно вызвать следующий URL для выполнения некоторых задач: http://example.com?foo=param:

wp_get_http_headers( 'http://example.com?foo=param' );

Изменения

Функция была введена с версии 1.5.1.

Исходный код функции

Ниже представлен исходный код функции wp_get_http_headers:

function wp_get_http_headers( $url, $deprecated = false ) {
    if ( ! empty( $deprecated ) ) {
        _deprecated_argument( __FUNCTION__, '2.7.0' );
    }

    $response = wp_safe_remote_head( $url );

    if ( is_wp_error( $response ) ) {
        return false;
    }

    return wp_remote_retrieve_headers( $response );
}

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

При работе с HTTP API могут быть полезны следующие функции:

• status_header()
• wp_http_validate_url()
• wp_remote_get()
• wp_remote_head()
• wp_remote_post()
• wp_remote_request()
• wp_remote_retrieve_body()
• wp_remote_retrieve_cookie()
• wp_remote_retrieve_cookie_value()
• wp_remote_retrieve_cookies()
• wp_remote_retrieve_header()
• wp_remote_retrieve_headers()
• wp_remote_retrieve_response_code()
• wp_remote_retrieve_response_message()
• wp_safe_remote_request()

Заключение

Функция wp_get_http_headers() — это простой и эффективный способ получить информацию о заголовках HTTP с указанного URL. Это особенно полезно для разработчиков, работающих с API и сторонними веб-сервисами.