WP_REMOTE_RETRIEVE_RESPONSE_CODE() │ WP 2.7.0

Функция wp_remote_retrieve_response_code() позволяет получить только код ответа от сервера, основываясь на исходном ответе.

Если передать неправильное значение параметра, функция вернет пустую строку.

Возврат

Функция возвращает целое число или строку. Код ответа как целое число. Пустая строка, если передан неправильный параметр.

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

$code = wp_remote_retrieve_response_code( $response );

Параметр

• $response (array|WP_Error) (обязательный) — HTTP-ответ.

Примеры

Пример 1: Получение кода ответа сервера на наш запрос

$response = wp_remote_get( 'http://httpbin.org/get?a=b&c=d' );
$code = wp_remote_retrieve_response_code( $response );

echo $code; //> 200

В этом примере мы отправляем GET-запрос на http://httpbin.org/get?a=b&c=d и получаем код ответа от сервера. Код 200 означает, что запрос выполнен успешно.

Обратите внимание на функцию status_header(), где можно узнать возможные коды ответа (статусы ответа) и их значения.

Изменения

• С версии 2.7.0 — функция была введена.

Код функции

function wp_remote_retrieve_response_code( $response ) {
    if ( is_wp_error( $response ) || ! isset( $response['response'] ) || ! is_array( $response['response'] ) ) {
        return '';
    }

    return $response['response']['code'];
}

Объяснение кода

1. Проверка на ошибку: Если $response — это ошибка (используется функция is_wp_error()) или если в ответе нет массива под ключом response, функция возвращает пустую строку.
2. Возврат кода: Если проверки пройдены, функция возвращает код ответа с помощью $response['response']['code'].

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

• HTTP API (CURL REMOTE)
  • status_header()
  • wp_get_http_headers()
  • 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_message()
  • wp_safe_remote_request()

Эта функция является частью более широкой системы работы с HTTP в WordPress, и понимание ее поможет лучше использовать API WordPress.