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

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

Простейший пример с последовательным выводом:

<?php
ob_start();
echo 'Первая часть вывода';
ob_flush();
flush();

sleep(1);
echo 'Вторая часть вывода';
ob_end_flush();
?>

Первая часть вывода
(пауза 1 секунда)
Вторая часть вывода

Пример работы с несколькими уровнями буферизации:

<?php
ob_start(); // уровень 1
echo 'Уровень 1: Первый блок';
ob_start(); // уровень 2
echo 'Уровень 2: Внутренний блок';
ob_flush(); // отправит буфер уровня 2
flush();
echo '\nПосле flush';
ob_end_flush(); // отправит буфер уровня 1
?>

Уровень 2: Внутренний блок
После flush
Уровень 1: Первый блок

Похожие функции в PHP

Отправляет содержимое буфера и завершает буферизацию. В отличие от ob_flush(), эта функция также отключает буферизацию текущего уровня.

Отправляет содержимое буфера, возвращает его как строку и завершает буферизацию. Полезно, когда нужно и отправить данные, и сохранить их для дальнейшей обработки.

Очищает системные буферы вывода, не влияя на буферы PHP. Часто используется вместе с ob_flush() для гарантированной отправки данных клиенту.

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

ob_flush() подходит для постепенной отправки данных при активной буферизации. ob_end_flush() используется, когда отправка должна завершить буферизацию. ob_get_flush() применяется, если требуется дополнительно обработать отправляемые данные.

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

Ob flush в Python

В веб-фреймворках Python, таких как Flask или Django, используется концепция генераторов или потоковой передачи ответов:

from flask import Flask, Response
import time

app = Flask(__name__)

@app.route('/stream')
def stream():
    def generate():
        yield 'Первая часть\n'
        time.sleep(1)
        yield 'Вторая часть\n'
    return Response(generate(), content_type='text/plain')

if __name__ == '__main__':
    app.run()

В Node.js для потоковой передачи используются потоки (Streams):

const http = require('http');

http.createServer((req, res) => {
    res.write('Первая часть');
    res.flush(); // или res.flushHeaders()
    
    setTimeout(() => {
        res.write('Вторая часть');
        res.end();
    }, 1000);
}).listen(3000);

В отличие от PHP, где буферизация управляется отдельными функциями, в Python и JavaScript часто используются встроенные механизмы потоковой передачи или генераторы, которые более интегрированы в архитектуру языка и фреймворков.

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

Вызов ob_flush() без предварительного включения буферизации вызовет предупреждение:

<?php
ob_flush(); // Вызов без ob_start()
?>

PHP Warning: ob_flush(): failed to flush buffer. No buffer to flush

Попытка отправить содержимое буфера после отправки заголовков HTTP:

<?php
header('Content-Type: text/html');
ob_start();
echo 'Контент';
// Отправка дополнительных заголовков после контента
ob_flush();
header('X-Custom: value'); // Ошибка
?>

PHP Warning: Cannot modify header information - headers already sent

Недостаточно вызвать только ob_flush() для отправки данных клиенту:

<?php
ob_start();
for ($i = 1; $i <= 5; $i++) {
    echo "Шаг $i\n";
    ob_flush(); // Буфер PHP очищен
    // но данные могут остаться в буферах веб-сервера
    sleep(1);
}
ob_end_flush();
?>

В этом случае рекомендуется также вызывать flush() после ob_flush().

Изменения в последних версиях PHP

В PHP 8.0 не было внесено существенных изменений в работу функции ob_flush(). Основные изменения в системе буферизации вывода произошли в более ранних версиях:

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

Оптимизирована внутренняя реализация буферизации, что повысило производительность при работе с большими объемами данных.

В PHP 8.1 и 8.2 не зафиксировано изменений, специфичных для функции ob_flush(), однако общие улучшения системы ввода-вывода положительно влияют на ее работу.

Расширенные примеры использования

Пример отправки прогресса выполнения длительной операции:

<?php
ob_start();
header('Content-Type: text/html; charset=utf-8');
echo '<div id="progress"></div>';
ob_flush();
flush();

for ($i = 0; $i <= 100; $i += 10) {
    echo '<script>document.getElementById("progress").innerHTML="Прогресс: ' . $i . '%";</script>';
    ob_flush();
    flush();
    usleep(300000);
}
ob_end_flush();
?>

Постепенная отправка большого объема данных:

<?php
ob_start();
header('Content-Type: text/plain');

$largeData = str_repeat('Данные,', 1000);
$chunks = str_split($largeData, 100);

foreach ($chunks as $chunk) {
    echo $chunk;
    ob_flush();
    flush();
    usleep(10000);
}
ob_end_flush();
?>

Использование совместно с ob_start() и callback-функцией:

<?php
function process_buffer($buffer) {
    return strtoupper($buffer);
}

ob_start('process_buffer');
echo 'текст в нижнем регистре';
ob_flush(); // Выведет 'ТЕКСТ В НИЖНЕМ РЕГИСТРЕ'
ob_end_flush();
?>

Работа с определенным уровнем буферизации:

<?php
ob_start(); // уровень 1
echo 'Уровень 1\n';
ob_start(); // уровень 2
echo 'Уровень 2\n';

ob_flush(); // отправит буфер уровня 2

ob_start(); // новый уровень 2
echo 'Новый уровень 2\n';
ob_end_flush(); // отправит новый уровень 2
ob_end_flush(); // отправит уровень 1
?>

Уровень 2
Новый уровень 2
Уровень 1