Ob start: примеры (PHP)

Простые примеры использования

Код:

<?php
ob_start();
echo "Этот текст попадёт в буфер";
$content = ob_get_clean();
echo "Захваченный контент: " . $content;
?>

Результат:

Захваченный контент: Этот текст попадёт в буфер

Код:

<?php
function process_buffer($buffer, $phase) {
    return strtoupper($buffer);
}
ob_start('process_buffer');
echo "текст в нижнем регистре";
ob_end_flush();
?>

Результат:

ТЕКСТ В НИЖНЕМ РЕГИСТРЕ

Код:

<?php
ob_start(null, 0, PHP_OUTPUT_HANDLER_CLEANABLE);
echo "Содержимое буфера";
ob_clean(); // Буфер очищается без вывода
?>

Альтернативные функции PHP

Комбинация этих функций позволяет получить содержимое буфера без немедленного вывода. Отличие от ob_get_clean в разделении операций получения и очистки.

Функция добавляет переменные перезаписи URL, что полезно для управления сессиями. Работает совместно с буферизацией вывода.

ob_list_handlers возвращает список активных обработчиков. ob_get_level определяет уровень вложенности буферов. Используются в сложных сценариях с многоуровневой буферизацией.

Аналоги в других языках

Код:

from io import StringIO
import sys
old_stdout = sys.stdout
sys.stdout = buffer = StringIO()
print("Захваченный вывод")
sys.stdout = old_stdout
content = buffer.getvalue()
print(f"Результат: {content}")

Результат:

Результат: Захваченный вывод

Код:

const originalLog = console.log
let captured = []
console.log = (...args) => {
    captured.push(args.join(' '))
}
console.log('Текст для захвата')
console.log = originalLog
console.log('Захвачено:', captured.join(', '))

Результат в консоли:

Захвачено: Текст для захвата

Позволяет захватывать вывод в байтовый массив с последующим преобразованием в строку.

Распространённые ошибки

Код:

<?php
ob_start();
ob_start();
echo "Внутренний буфер";
$inner = ob_get_clean();
echo "Внешний буфер";
$outer = ob_get_clean();
echo $inner . " | " . $outer;
?>

Результат:

Внутренний буфер | Внешний буфер

Код:

<?php
ob_start();
ob_end_clean();
ob_end_clean(); // Ошибка
?>

Результат:

PHP Notice: ob_end_clean(): failed to delete buffer. No buffer to delete

Код:

<?php
ob_start(function($buffer) {
    return 123; // Должна возвращаться строка
});
echo "тест";
ob_end_flush();
?>

Результат:

PHP Warning: ob_end_flush(): failed to send buffer...

Изменения в новых версиях PHP

Добавлена строгая проверка типов для аргументов функции. Неверные типы теперь вызывают TypeError вместо предупреждений.

Значение по умолчанию для параметра flags изменено с PHP_OUTPUT_HANDLER_STDFLAGS на комбинацию PHP_OUTPUT_HANDLER_CLEANABLE | PHP_OUTPUT_HANDLER_FLUSHABLE | PHP_OUTPUT_HANDLER_REMOVABLE.

Введен третий параметр для более точного контроля над обработчиками вывода, что расширило возможности буферизации.

Расширенные примеры

Код:

<?php
function minify_html($buffer) {
    $search = ['/\s+/', '/\s*(<|>)\s*/'];
    $replace = [' ', '$1'];
    return preg_replace($search, $replace, $buffer);
}
ob_start('minify_html');
?>
<div>
    <p>   Текст   с   лишними   пробелами   </p>
</div>
<?php ob_end_flush(); ?>

Результат:

<div><p>Текст с лишними пробелами</p></div>

Код:

<?php
ob_start(function($buffer) {
    return "[Уровень2: $buffer]";
});
echo "Контент";
ob_start(function($buffer) {
    return "{Уровень1: $buffer}";
});
echo "Вложенный";
$inner = ob_get_clean();
echo $inner;
$outer = ob_get_clean();
echo $outer;
?>

Результат:

[Уровень2: {Уровень1: Вложенный}]

Код:

<?php
$prefix = "Обработано: ";
$callback = function($buffer) use ($prefix) {
    return $prefix . strlen($buffer) . " символов";
};
ob_start($callback);
echo "Пример текста";
ob_end_flush();
?>

Результат:

Обработано: 12 символов

Код:

<?php
ob_start(null, 10);
for($i = 1; $i <= 25; $i++) {
    echo $i;
    if($i % 10 === 0) ob_flush();
}
ob_end_flush();
?>

Результат с поэтапной отправкой:

12345678910111213141516171819202122232425