wp_remote_retrieve_header

The timeline below displays how wordpress function wp_remote_retrieve_header has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.9

/**
 * Retrieve a single header by name from the raw response.
 *
 * @since 2.7.0
 *
 * @param array|WP_Error $response HTTP response.
 * @param string         $header   Header name to retrieve value from.
 * @return array|string The header(s) value(s). Array if multiple headers with the same name are retrieved.
 *                      Empty string if incorrect parameter given, or if the header doesn't exist.
 */
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 '';
}

WordPress Version: 5.3

/**
 * Retrieve a single header by name from the raw response.
 *
 * @since 2.7.0
 *
 * @param array|WP_Error $response HTTP response.
 * @param string         $header   Header name to retrieve value from.
 * @return string The header value. Empty string on if incorrect parameter given, or if the header doesn't exist.
 */
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 '';
}

WordPress Version: 4.6

/**
 * Retrieve a single header by name from the raw response.
 *
 * @since 2.7.0
 *
 * @param array  $response
 * @param string $header Header name to retrieve value from.
 * @return string The header value. Empty string on if incorrect parameter given, or if the header doesn't exist.
 */
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 '';
}

WordPress Version: 4.3

/**
 * Retrieve a single header by name from the raw response.
 *
 * @since 2.7.0
 *
 * @param array  $response
 * @param string $header Header name to retrieve value from.
 * @return string The header value. Empty string on if incorrect parameter given, or if the header doesn't exist.
 */
function wp_remote_retrieve_header($response, $header)
{
    if (is_wp_error($response) || !isset($response['headers']) || !is_array($response['headers'])) {
        return '';
    }
    if (array_key_exists($header, $response['headers'])) {
        return $response['headers'][$header];
    }
    return '';
}

WordPress Version: 4.0

/**
 * Retrieve a single header by name from the raw response.
 *
 * @since 2.7.0
 *
 * @param array $response
 * @param string $header Header name to retrieve value from.
 * @return string The header value. Empty string on if incorrect parameter given, or if the header doesn't exist.
 */
function wp_remote_retrieve_header($response, $header)
{
    if (is_wp_error($response) || !isset($response['headers']) || !is_array($response['headers'])) {
        return '';
    }
    if (array_key_exists($header, $response['headers'])) {
        return $response['headers'][$header];
    }
    return '';
}

WordPress Version: 3.7

/**
 * Retrieve a single header by name from the raw response.
 *
 * @since 2.7.0
 *
 * @param array $response
 * @param string $header Header name to retrieve value from.
 * @return string The header value. Empty string on if incorrect parameter given, or if the header doesn't exist.
 */
function wp_remote_retrieve_header(&$response, $header)
{
    if (is_wp_error($response) || !isset($response['headers']) || !is_array($response['headers'])) {
        return '';
    }
    if (array_key_exists($header, $response['headers'])) {
        return $response['headers'][$header];
    }
    return '';
}