ob_end_clean
(PHP 4, PHP 5, PHP 7)
ob_end_clean — Очищает (стирает) буфер вывода и отключает буферизацию вывода
Описание
Эта функция удаляет содержимое самого верхнего буфера вывода и отключает эту буферизацию. Если вы хотите использовать содержимое буфера, то вам необходимо вызвать ob_get_contents() перед ob_end_clean(), так как все содержимое буфера удаляется при вызове ob_end_clean().
Буфер вывода должен запускаться функцией ob_start() с флагами PHP_OUTPUT_HANDLER_CLEANABLE и PHP_OUTPUT_HANDLER_REMOVABLE. Иначе не сработает ob_end_clean().
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки. Основной причиной неудачного завершения работы функции
является ее вызов без активной буферизации, или если буфер не может
быть удален (специальный тип буфера).
Ошибки
Если функция завершается ошибкой генерируется E_NOTICE.
Примеры
Следующий пример показывает простой способ избавиться от всех выходных буферов:
Пример #1 Пример использования функции ob_end_clean()
<?php
ob_start();
echo 'Текст, который не отобразится.';
ob_end_clean();
?>
Смотрите также
- ob_start() - Включение буферизации вывода
- ob_get_contents() - Возвращает содержимое буфера вывода
- ob_flush() - Сброс (отправка) буфера вывода
Коментарии
Note that if you started called ob_start with a callback, that callback will still be called even if you discard the OB with ob_end_clean.
Because there is no way of removing the callback from the OB once you've set it, the only way to stop the callback function from having any effect is to do something like:
<?php
$ignore_callback = false;
ob_start('my_callback');
...
if($need_to_abort) {
$ignore_callback = true;
ob_end_clean();
...
}
function my_callback(&$buffer) {
if($GLOBALS['ignore_callback']) {
return "";
}
...
}
?>
Take note that if you change zlib output compression setting in between ob_start and ob_end_clean or ob_end_flush, you will get an error: ob_end_flush() failed to delete buffer zlib output compression
Example:
<?php
ob_start();
$output = ob_get_contents();
ini_set('zlib.output_compression', '1');
ob_end_clean();
?>
ob_end_clean(); in this example will throw the error.