wp_remote_retrieve_body()WP 2.7.0

Получает тело (контент) ответа, который был получен с помощью любой из функций типа wp_remote_*(), например wp_remote_get().

Эта функция принимает только один параметр, ответ от любой из функций wp_remote_*(), например wp_remote_get().

Используйте wp_remote_retrieve_response_code(), когда нужно получить только код ответа (например 200), .

Хуков нет.

Возвращает

Строку.

  • Строку - тело ответа (контент) в виде строки.
  • Пустую строку - когда ответ пустой или неправильно передан параметр.

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

wp_remote_retrieve_body( $response );
$response(массив|WP_Error) (обязательный)

Ответ полученный с помощью одной из функций WP HTTP API, например: wp_remote_get().

Функция понимает, если передать ей объект ошибки WP_Error.

Примеры

0

#1 Получение тела ответа

Получим данные пользователя Github:

$response = wp_remote_get( 'https://api.github.com/users/doiftrue' );
$body = wp_remote_retrieve_body( $response );

// decode data
$api_response = json_decode( $body, true );

print_r( $api_response );

/* выведет:
Array
(
	[login] => doiftrue
	[id] => 15121552
	[node_id] => MDQ6VXNlcjE1MTIxNTUy
	[avatar_url] => https://avatars.githubusercontent.com/u/15121552?v=4
	[gravatar_id] =>
	[url] => https://api.github.com/users/doiftrue
	[html_url] => https://github.com/doiftrue
	[followers_url] => https://api.github.com/users/doiftrue/followers
	[following_url] => https://api.github.com/users/doiftrue/following{/other_user}
	[gists_url] => https://api.github.com/users/doiftrue/gists{/gist_id}
	[starred_url] => https://api.github.com/users/doiftrue/starred{/owner}{/repo}
	[subscriptions_url] => https://api.github.com/users/doiftrue/subscriptions
	[organizations_url] => https://api.github.com/users/doiftrue/orgs
	[repos_url] => https://api.github.com/users/doiftrue/repos
	[events_url] => https://api.github.com/users/doiftrue/events{/privacy}
	[received_events_url] => https://api.github.com/users/doiftrue/received_events
	[type] => User
	[site_admin] =>
	[name] => Kama
	[company] =>
	[blog] => https://wp-kama.ru
	[location] =>
	[email] =>
	[hireable] =>
	[bio] =>
	[twitter_username] =>
	[public_repos] => 29
	[public_gists] => 2
	[followers] => 14
	[following] => 2
	[created_at] => 2015-10-14T08:52:55Z
	[updated_at] => 2022-02-14T12:17:11Z
)
*/
0

#2 Получение удаленной страницы и её кэширование

function get_remote_html( $url, $trans_name = 'foo_remote_html' ) {
	// Проверим транзитную опцию, если её нет получим удаленных HTML
	if( false === ( $html = get_transient($trans_name) ) ){
		// Получаем HTML
		$response = wp_remote_get( $url );

		// Проверим на ошибки
		if ( is_wp_error( $response ) ) {
			return;
		}

		// Получим тело
		$html = wp_remote_retrieve_body( $response );

		// Запишем полученный запрос в транзитную опцию на 24 часа
		set_transient( $trans_name, $html, 24 * HOUR_IN_SECONDS );
	}

	return $html;
}

// вызываем функцию
$html = get_remote_html('http://example.com/some-remote-file.html', 'my_trans_name');

Список изменений

С версии 2.7.0 Введена.

Код wp_remote_retrieve_body() WP 6.6.2

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

	return $response['body'];
}