# parse_blocks()

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

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

## Сигнатура

```php
parse_blocks( string $content ): array[]
```

## Описание

Получив HTML-документ, эта функция полностью разбирает содержимое блоков, создавая дерево блоков и их содержимого, а также содержимое верхнего уровня, не относящееся к блокам, которое представляется как блок без blockName.
Эта функция может потреблять много памяти для некоторых документов, особенно с глубоко вложенными блоками или блоками с обширными значениями атрибутов. Кроме того, она должна разобрать весь документ за одну атомарную операцию.
Если полностью разобранный документ не нужен, рассмотрите использование WP_Block_Processor, поскольку он предоставляет потоковый и малозатратный интерфейс для поиска блоков.

## Параметры

- `$content` `string` — обязательный. Содержимое записи.

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

`array[]` — ...$0 array An associative array of a single parsed block object. See WP_Block_Parser_Block. blockName string|nullName of block. attrs arrayAttributes from block comment delimiters. innerBlocks array[]List of inner blocks. An array of arrays that have the same structure as this one. innerHTML stringHTML from inside block comment delimiters. innerContent arrayList of string fragments and null markers where inner blocks were found. Source function parse_blocks( $content ) { /** * Filter to allow plugins to replace the server-side block parser. * * @since 5.0.0 * * @param string $parser_class Name of block parser class. */ $parser_class = apply_filters( 'block_parser_class', 'WP_Block_Parser' ); $parser = new $parser_class(); return $parser->parse( $content ); }

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

Файл: `wp-includes/blocks.php:2474`

```php
function parse_blocks( $content ) {
	/**
	 * Filter to allow plugins to replace the server-side block parser.
	 *
	 * @since 5.0.0
	 *
	 * @param string $parser_class Name of block parser class.
	 */
	$parser_class = apply_filters( 'block_parser_class', 'WP_Block_Parser' );

	$parser = new $parser_class();
	return $parser->parse( $content );
}
```

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

- 5.0.0 — Introduced.

## Связанные

Использует: [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`apply_block_hooks_to_content_from_post_object`](https://chugunov.pro/api-wordpress/functions/apply_block_hooks_to_content_from_post_object/), [`resolve_pattern_blocks`](https://chugunov.pro/api-wordpress/functions/resolve_pattern_blocks/), [`apply_block_hooks_to_content`](https://chugunov.pro/api-wordpress/functions/apply_block_hooks_to_content/), [`update_ignored_hooked_blocks_postmeta`](https://chugunov.pro/api-wordpress/functions/update_ignored_hooked_blocks_postmeta/), [`inject_ignored_hooked_blocks_metadata_attributes`](https://chugunov.pro/api-wordpress/functions/inject_ignored_hooked_blocks_metadata_attributes/), [`wp_get_post_content_block_attributes`](https://chugunov.pro/api-wordpress/functions/wp_get_post_content_block_attributes/), `WP_REST_Block_Patterns_Controller::prepare_item_for_response`, [`wp_generate_block_templates_export_file`](https://chugunov.pro/api-wordpress/functions/wp_generate_block_templates_export_file/), [`_inject_theme_attribute_in_block_template_content`](https://chugunov.pro/api-wordpress/functions/_inject_theme_attribute_in_block_template_content/), [`_remove_theme_attribute_in_block_template_content`](https://chugunov.pro/api-wordpress/functions/_remove_theme_attribute_in_block_template_content/), `WP_Widget_Block::get_dynamic_classname`, `WP_REST_Templates_Controller::prepare_item_for_response`, [`filter_block_content`](https://chugunov.pro/api-wordpress/functions/filter_block_content/), [`do_blocks`](https://chugunov.pro/api-wordpress/functions/do_blocks/), [`excerpt_remove_blocks`](https://chugunov.pro/api-wordpress/functions/excerpt_remove_blocks/), [`get_post_galleries`](https://chugunov.pro/api-wordpress/functions/get_post_galleries/).

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