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-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. |

