# rest_is_field_included()

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

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

## Сигнатура

```php
rest_is_field_included( string $field, array $fields ): bool
```

## Описание

Если передано родительское поле, наличие любого вложенного поля внутри него заставит метод вернуть true. Например, «title» вернёт true, если указано любое из title, title.raw или title.rendered.

## Параметры

- `$field` `string` — обязательный. Поле, проверяемое на включение в тело ответа.
- `$fields` `array` — обязательный. Массив строковых полей, поддерживаемых конечной точкой.

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

`bool`

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

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

```php
function rest_is_field_included( $field, $fields ) {
	if ( in_array( $field, $fields, true ) ) {
		return true;
	}

	foreach ( $fields as $accepted_field ) {
		/*
		 * Check to see if $field is the parent of any item in $fields.
		 * A field "parent" should be accepted if "parent.child" is accepted.
		 */
		if ( str_starts_with( $accepted_field, "$field." ) ) {
			return true;
		}
		/*
		 * Conversely, if "parent" is accepted, all "parent.child" fields
		 * should also be accepted.
		 */
		if ( str_starts_with( $field, "$accepted_field." ) ) {
			return true;
		}
	}

	return false;
}
```

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

- 5.3.0 — Introduced.

## Связанные

Используется в: `WP_REST_Icons_Controller::prepare_item_for_response`, `WP_REST_Abilities_V1_Categories_Controller::prepare_item_for_response`, `WP_REST_Abilities_V1_List_Controller::prepare_item_for_response`, `WP_REST_Font_Faces_Controller::prepare_item_for_response`, `WP_REST_Font_Families_Controller::prepare_item_for_response`, `WP_REST_Font_Collections_Controller::prepare_item_for_response`, `WP_REST_Template_Autosaves_Controller::prepare_item_for_response`, `WP_REST_Template_Revisions_Controller::prepare_item_for_response`, `WP_REST_Navigation_Fallback_Controller::prepare_item_for_response`, `WP_REST_Global_Styles_Revisions_Controller::prepare_item_for_response`, `WP_REST_Block_Patterns_Controller::prepare_item_for_response`, `WP_REST_Block_Pattern_Categories_Controller::prepare_item_for_response`, `WP_REST_Menu_Items_Controller::prepare_item_for_response`, `WP_REST_Global_Styles_Controller::get_theme_item`, `WP_REST_Global_Styles_Controller::prepare_item_for_response`, `WP_REST_Menus_Controller::prepare_item_for_response`, `WP_REST_Menu_Locations_Controller::prepare_item_for_response`, `WP_REST_Widgets_Controller::prepare_item_for_response`, `WP_REST_Sidebars_Controller::prepare_item_for_response`, `WP_REST_Templates_Controller::prepare_item_for_response`, `WP_REST_Widget_Types_Controller::prepare_item_for_response`, `WP_REST_Application_Passwords_Controller::prepare_item_for_response`, `WP_REST_Block_Directory_Controller::prepare_item_for_response`, `WP_REST_Plugins_Controller::prepare_item_for_response`, `WP_REST_Block_Types_Controller::prepare_item_for_response`, `WP_REST_Search_Controller::prepare_item_for_response`, `WP_REST_Themes_Controller::prepare_item_for_response`, `WP_REST_Users_Controller::prepare_item_for_response`, `WP_REST_Revisions_Controller::prepare_item_for_response`, `WP_REST_Terms_Controller::prepare_item_for_response`, `WP_REST_Posts_Controller::prepare_item_for_response`, `WP_REST_Taxonomies_Controller::prepare_item_for_response`, `WP_REST_Post_Types_Controller::prepare_item_for_response`, `WP_REST_Controller::add_additional_fields_to_object`, `WP_REST_Comments_Controller::prepare_item_for_response`, `WP_REST_Server::get_index`.

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