ob_get_clean

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

ob_get_cleanПолучает содержимое активного буфера вывода и выключает буфер

Описание

ob_get_clean(): string|false

Функция вызывает обработчик вывода с флагами PHP_OUTPUT_HANDLER_CLEAN и PHP_OUTPUT_HANDLER_FINAL, отбрасывает значение, которое вернул обработчик, возвращает содержимое активного буфера вывода и отключает его.

Функция ob_get_clean() завершится ошибкой, если активный буфер вывода запустили без флага PHP_OUTPUT_HANDLER_REMOVABLE.

Функция ob_get_clean() отбросит содержимое активного буфера вывода, даже если буфер запустили без флага PHP_OUTPUT_HANDLER_CLEANABLE.

Список параметров

У этой функции нет параметров.

Возвращаемые значения

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

Предостережение

Функция ob_get_clean() вернёт значение false, но не выдаст ошибку уровня E_NOTICE, если нет активного буфера вывода.

Ошибки

Функция генерирует ошибку уровня E_NOTICE, если возникла ошибка.

Примеры

Пример #1 Пример получения и отключения активного буфера вывода функцией ob_get_clean()

<?php

ob_start
();

echo
"Привет, мир!";

$out = ob_get_clean();
$out = strtolower($out);

var_dump($out);

?>

Результат выполнения приведённого примера:

string(21) "Привет, мир!"

Смотрите также

  • ob_start() - Включает буферизацию вывода
  • ob_get_contents() - Возвращает содержимое буфера вывода
  • ob_clean() - Очищает (стирает) содержимое активного буфера вывода
  • ob_end_clean() - Очищает (стирает) содержимое активного буфера вывода и отключает его
  • ob_get_flush() - Сбрасывает (отправляет) возвращённое активным обработчиком вывода значение, возвращает содержимое активного буфера вывода и отключает его