# rest_filter_response_fields()

URL: https://chugunov.pro/api-wordpress/functions/rest_filter_response_fields/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 4.8.0.

## Сигнатура

```php
rest_filter_response_fields( WP_REST_Response $response, WP_REST_Server $server, WP_REST_Request $request ): WP_REST_Response
```

## Описание

Фильтрует ответ REST API, оставляя только разрешённый набор полей объекта ответа.

## Параметры

- `$response` `WP_REST_Response` — обязательный. Текущий обрабатываемый ответ.
- `$server` `WP_REST_Server` — обязательный. Экземпляр ResponseHandler (обычно WP_REST_Server).
- `$request` `WP_REST_Request` — обязательный. Запрос, использованный для формирования текущего ответа.

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

`WP_REST_Response`

## Исходный код

Файл: `wp-includes/rest-api.php:932`

```php
function rest_filter_response_fields( $response, $server, $request ) {
	if ( ! isset( $request['_fields'] ) || $response->is_error() ) {
		return $response;
	}

	$data = $response->get_data();

	$fields = wp_parse_list( $request['_fields'] );

	if ( 0 === count( $fields ) ) {
		return $response;
	}

	// Trim off outside whitespace from the comma delimited list.
	$fields = array_map( 'trim', $fields );

	// Create nested array of accepted field hierarchy.
	$fields_as_keyed = array();
	foreach ( $fields as $field ) {
		$parts = explode( '.', $field );
		$ref   = &$fields_as_keyed;
		while ( count( $parts ) > 1 ) {
			$next = array_shift( $parts );
			if ( isset( $ref[ $next ] ) && true === $ref[ $next ] ) {
				// Skip any sub-properties if their parent prop is already marked for inclusion.
				break 2;
			}
			$ref[ $next ] = $ref[ $next ] ?? array();
			$ref          = &$ref[ $next ];
		}
		$last         = array_shift( $parts );
		$ref[ $last ] = true;
	}

	if ( wp_is_numeric_array( $data ) ) {
		$new_data = array();
		foreach ( $data as $item ) {
			$new_data[] = _rest_array_intersect_key_recursive( $item, $fields_as_keyed );
		}
	} else {
		$new_data = _rest_array_intersect_key_recursive( $data, $fields_as_keyed );
	}

	$response->set_data( $new_data );

	return $response;
}
```

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

- 4.8.0 — Introduced.

## Связанные

Использует: [`_rest_array_intersect_key_recursive`](https://chugunov.pro/api-wordpress/functions/_rest_array_intersect_key_recursive/), [`wp_parse_list`](https://chugunov.pro/api-wordpress/functions/wp_parse_list/), [`wp_is_numeric_array`](https://chugunov.pro/api-wordpress/functions/wp_is_numeric_array/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/rest_filter_response_fields/