# wp_template_enhancement_output_buffer

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

Тип: хук-фильтр.
Появился в версии: 6.9.0.

## Сигнатура

```php
apply_filters( 'wp_template_enhancement_output_buffer', string $filtered_output, string $output )
```

## Описание

Этот фильтр применяется только к HTML-выводу подключённого шаблона. Он представляет собой прогрессивное улучшение, предназначенное для таких задач, как оптимизация разметки для повышения производительности загрузки страниц публичной части. Сайты не должны полагаться на применение этого фильтра, поскольку вместо этого может быть выбрана потоковая передача ответов. Функциям обратного вызова этого фильтра настоятельно не рекомендуется использовать регулярные выражения для какой-либо замены в выводе. Используйте HTML API (либо WP_HTML_Tag_Processor, либо WP_HTML_Processor) или же DOM\HtmlDocument начиная с PHP 8.4, который полностью поддерживает HTML5.
Не выводите ничего во время работы этого фильтра. Хотя фильтры обычно ничего не выводят, здесь это особенно важно, поскольку фильтр применяется во время работы функции обратного вызова буфера вывода. До PHP 8.5 вывод будет молча опущен, а начиная с этой версии будет выдано уведомление об устаревании.
Важно: поскольку этот фильтр применяется внутри функции обратного вызова буфера вывода (то есть обработчика вывода), любые добавленные к фильтру функции обратного вызова не должны пытаться запускать собственные буферы вывода. В противном случае PHP выдаст фатальную ошибку: «Cannot use output buffering in output buffering display handlers.»

## Параметры

- `$filtered_output` `string` — обязательный. Буфер вывода улучшения HTML-шаблона.
- `$output` `string` — обязательный. Исходный буфер вывода HTML-шаблона.

## Фильтруемое значение

Буфер вывода улучшения HTML-шаблона.

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

Файл: `wp-includes/template.php:1019`

```php
$filtered_output = (string) apply_filters( 'wp_template_enhancement_output_buffer', $filtered_output, $output );
```

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

- 6.9.0 — Introduced.

## Связанные

Используется в: [`wp_finalize_template_enhancement_output_buffer`](https://chugunov.pro/api-wordpress/functions/wp_finalize_template_enhancement_output_buffer/).

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