Hi,
this is just to add a behavior that I haven't understud at first place.
ob_get_flush actually returns the content of the buffer as a text but also it sends the buffer back to the browser so that it's displayed on user screen.
Use ob_get_clean if you do not want the buffer to be send to the user
ob_get_flush
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
ob_get_flush — Сбрасывает (отправляет) возвращённое активным обработчиком вывода значение, возвращает содержимое активного буфера вывода и отключает его
Описание
Функция вызывает обработчик вывода
(с флагом PHP_OUTPUT_HANDLER_FINAL),
сбрасывает (отправляет) возвращённое им значение,
возвращает содержимое активного буфера вывода
и отключает активный буфер вывода.
Функция ob_get_flush() завершится неудачно,
если активный буфер вывода был запущен без флага
PHP_OUTPUT_HANDLER_REMOVABLE.
Функция ob_get_flush() сбросит (отправит)
возвращённое обработчиком вывода значение,
даже если активный буфер вывода был запущен без флага
PHP_OUTPUT_HANDLER_FLUSHABLE.
Список параметров
У этой функции нет параметров.
Возвращаемые значения
Возвращает содержимое активного буфера вывода в случае успешного выполнения
или false в случае возникновения ошибки.
Ошибки
Если функция завершается неудачно, она выдаёт ошибку уровня E_NOTICE.
Примеры
Пример #1 Пример использования функции ob_get_flush()
<?php
// Включена директива буфера вывода: output_buffering=On
print_r(ob_list_handlers());
// Сохранить буфер в файл
$buffer = ob_get_flush();
file_put_contents('buffer.txt', $buffer);
print_r(ob_list_handlers());
?>Результат выполнения приведённого примера:
Array
(
[0] => default output handler
)
Array
(
)
Смотрите также
- ob_start() - Включает буферизацию вывода
- ob_get_contents() - Возвращает содержимое буфера вывода
- ob_flush() - Сбрасывает (отправляет) возвращённое активным обработчиком вывода значение
- ob_end_flush() - Сбрасывает (отправляет) возвращаемое значение активного обработчика вывода и отключает активный буфер вывода
- ob_get_clean() - Получает содержимое активного буфера вывода и выключает его
add a note
User Contributed Notes 4 notes
info at pcdoctor dot fr ¶
16 years ago
taras dot dot dot di at gmail dot com ¶
16 years ago
I don't know how exactly this works, but if you call this function, PHP would behave as if headers have been sent (even though the output has gone to a string).
This means that you can't call this function, and then call setcookie for example.
This was verified by trial and error
zubin@byron ¶
19 years ago
I found this function is useful for storing output instead of displaying it. For example, I wanted to use an old function which echoed the ouput but I wanted it in a variable, not outputted immediately. Here's how:
<?php
// start generating html
$html = '<html><head>'; // etc
// start output buffering
ob_start();
// call function which outputs immediately
print_menu();
// append this to $html
$html .= ob_get_flush();
// empty output buffer
ob_clean();
?>
zubin@byron ¶
19 years ago
Correction to previous post: ob_get_clean() is better, ie:
<?php
// start generating html
$html = '<html><head>'; // etc
// start output buffering
ob_start();
// call function which outputs immediately
print_menu();
// append this to $html and empty buffer
$html .= ob_get_clean();
?>
