# wp_json_encode()

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

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

## Сигнатура

```php
wp_json_encode( mixed $value, int $flags, int $depth = 512 ): string|false
```

## Описание

Кодирует переменную в JSON с некоторыми проверками надёжности.

## Параметры

- `$value` `mixed` — обязательный. Переменная (обычно массив или объект) для кодирования в JSON.
- `$flags` `int` — необязательный. Опции, передаваемые в json_encode(). Значение по умолчанию 0.
- `$depth` `int` — необязательный, по умолчанию `512`. Максимальная глубина обхода $value. Должна быть больше 0.

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

`string|false`

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

Файл: `wp-includes/functions.php:4397`

```php
function wp_json_encode( $value, $flags = 0, $depth = 512 ) {
	$json = json_encode( $value, $flags, $depth );

	// If json_encode() was successful, no need to do more confidence checking.
	if ( false !== $json ) {
		return $json;
	}

	try {
		$value = _wp_json_sanity_check( $value, $depth );
	} catch ( Exception $e ) {
		return false;
	}

	return json_encode( $value, $flags, $depth );
}
```

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

- 6.5.0 — The $data parameter has been renamed to $value and the $options parameter to $flags for parity with PHP.
- 5.3.0 — No longer handles support for PHP < 5.6.
- 4.1.0 — Introduced.

## Связанные

Используется в: `WP_Sync_Post_Meta_Storage::add_update`, `WP_Sync_Post_Meta_Storage::set_awareness_state`, [`wp_collaboration_inject_setting`](https://chugunov.pro/api-wordpress/functions/wp_collaboration_inject_setting/), `WP_Script_Modules::print_script_module_translations`, [`wp_options_connectors_wp_admin_preload_data`](https://chugunov.pro/api-wordpress/functions/wp_options_connectors_wp_admin_preload_data/), [`wp_options_connectors_wp_admin_enqueue_scripts`](https://chugunov.pro/api-wordpress/functions/wp_options_connectors_wp_admin_enqueue_scripts/), [`wp_options_connectors_preload_data`](https://chugunov.pro/api-wordpress/functions/wp_options_connectors_preload_data/), [`wp_options_connectors_render_page`](https://chugunov.pro/api-wordpress/functions/wp_options_connectors_render_page/), [`wp_font_library_render_page`](https://chugunov.pro/api-wordpress/functions/wp_font_library_render_page/), [`wp_font_library_wp_admin_preload_data`](https://chugunov.pro/api-wordpress/functions/wp_font_library_wp_admin_preload_data/), [`wp_font_library_wp_admin_enqueue_scripts`](https://chugunov.pro/api-wordpress/functions/wp_font_library_wp_admin_enqueue_scripts/), [`wp_font_library_preload_data`](https://chugunov.pro/api-wordpress/functions/wp_font_library_preload_data/), [`_wp_enqueue_auto_register_blocks`](https://chugunov.pro/api-wordpress/functions/_wp_enqueue_auto_register_blocks/), [`wp_admin_bar_command_palette_menu`](https://chugunov.pro/api-wordpress/functions/wp_admin_bar_command_palette_menu/), `WP_Interactivity_API::add_load_on_client_navigation_attribute_to_script_modules`, [`wp_enqueue_command_palette_assets`](https://chugunov.pro/api-wordpress/functions/wp_enqueue_command_palette_assets/), [`wp_print_speculation_rules`](https://chugunov.pro/api-wordpress/functions/wp_print_speculation_rules/), [`wp_unique_id_from_values`](https://chugunov.pro/api-wordpress/functions/wp_unique_id_from_values/), `WP_Script_Modules::print_script_module_data`, [`insert_hooked_blocks_into_rest_response`](https://chugunov.pro/api-wordpress/functions/insert_hooked_blocks_into_rest_response/), [`wp_interactivity_data_wp_context`](https://chugunov.pro/api-wordpress/functions/wp_interactivity_data_wp_context/), `WP_Script_Modules::print_import_map`, [`inject_ignored_hooked_blocks_metadata_attributes`](https://chugunov.pro/api-wordpress/functions/inject_ignored_hooked_blocks_metadata_attributes/), `WP_REST_Font_Faces_Controller::prepare_item_for_database`, `WP_REST_Font_Families_Controller::prepare_item_for_database`, [`wp_remove_surrounding_empty_script_tags`](https://chugunov.pro/api-wordpress/functions/wp_remove_surrounding_empty_script_tags/), [`_wp_filter_post_meta_footnotes`](https://chugunov.pro/api-wordpress/functions/_wp_filter_post_meta_footnotes/), [`wp_attach_theme_preview_middleware`](https://chugunov.pro/api-wordpress/functions/wp_attach_theme_preview_middleware/), [`wp_block_theme_activate_nonce`](https://chugunov.pro/api-wordpress/functions/wp_block_theme_activate_nonce/), `WP_Style_Engine_Processor::combine_rules_selectors`, [`wp_add_global_styles_for_blocks`](https://chugunov.pro/api-wordpress/functions/wp_add_global_styles_for_blocks/), `WP_REST_Global_Styles_Controller::prepare_item_for_database`, [`wp_generate_block_templates_export_file`](https://chugunov.pro/api-wordpress/functions/wp_generate_block_templates_export_file/), [`wp_filter_global_styles_post`](https://chugunov.pro/api-wordpress/functions/wp_filter_global_styles_post/), [`block_editor_rest_api_preload`](https://chugunov.pro/api-wordpress/functions/block_editor_rest_api_preload/), [`rest_validate_enum`](https://chugunov.pro/api-wordpress/functions/rest_validate_enum/), `WP_Application_Passwords_List_Table::print_js_template_row`, [`serialize_block_attributes`](https://chugunov.pro/api-wordpress/functions/serialize_block_attributes/), `WP_Site_Health::wp_cron_scheduled_check`, [`enqueue_editor_block_styles_assets`](https://chugunov.pro/api-wordpress/functions/enqueue_editor_block_styles_assets/).

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