функция since 4.4.0

rest_ensure_response()

Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.

Сигнатура

rest_ensure_response( WP_REST_Response|WP_Error|WP_HTTP_Response|mixed $response ): WP_REST_Response|WP_Error

Описание

Реализует WP_REST_Response, что позволяет использовать set_status/header и подобные методы без дополнительной проверки объекта. Также допускает WP_Error для обозначения ответов с ошибкой, поэтому это значение следует проверять сразу.

Оригинал (английский)

This implements WP_REST_Response, allowing usage of set_status/header/etc without needing to double-check the object. Will also allow WP_Error to indicate error responses, so users should immediately check for this value.

Параметры

$response WP_REST_Response|WP_Error|WP_HTTP_Response|mixed обязательный
Ответ для проверки.

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

WP_REST_Response|WP_Error

WP_Error WP_REST_Response WP_REST_Response

Исходный код

wp-includes/rest-api.php:681

function rest_ensure_response( $response ) {
	if ( is_wp_error( $response ) ) {
		return $response;
	}

	if ( $response instanceof WP_REST_Response ) {
		return $response;
	}

	/*
	 * While WP_HTTP_Response is the base class of WP_REST_Response, it doesn't provide
	 * all the required methods used in WP_REST_Server::dispatch().
	 */
	if ( $response instanceof WP_HTTP_Response ) {
		return new WP_REST_Response(
			$response->get_data(),
			$response->get_status(),
			$response->get_headers()
		);
	}

	return new WP_REST_Response( $response );
}

История изменений

ВерсияОписание
4.4.0 Introduced.

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.