PHP 8.4.2 Released!

ob_get_flush

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

ob_get_flush Сбрасывает (отправляет) возвращённое активным обработчиком вывода значение, возвращает содержимое активного буфера вывода и отключает его

Описание

ob_get_flush(): string|false

Функция вызывает обработчик вывода (с флагом 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() - Получает содержимое активного буфера вывода и выключает буфер

Добавить

Примечания пользователей 3 notes

up
34
info at pcdoctor dot fr
16 years ago
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
up
-3
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
up
-5
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();
?>
To Top