ob_get_clean

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

ob_get_clean — Obtém o conteúdo do buffer de saída ativo e desliga-o

Descrição

ob_get_clean(): string|false

Esta função chama o manipulador de saída (com as opções PHP_OUTPUT_HANDLER_CLEAN e PHP_OUTPUT_HANDLER_FINAL), descarta seu valor de retorno, retorna o conteúdo do buffer de saída ativo e desliga o mesmo.

ob_get_clean() irá falhar sem um buffer de saída ativo iniciado com a opção PHP_OUTPUT_HANDLER_REMOVABLE.

ob_get_clean() irá descartar o conteúdo do buffer de saída ativo mesmo se tiver sido iniciado sem a opção PHP_OUTPUT_HANDLER_CLEANABLE.

Parâmetros

Esta função não possui parâmetros.

Valor Retornado

Retorna o conteúdo do buffer de saída ativo em caso de sucesso ou false em caso de falha.

Caution

ob_get_clean() retornará false mas não irá gerar um E_NOTICE se não houver buffer de saída ativo.

Erros/Exceções

Se a função falhar, ela gerará um E_NOTICE.

Exemplos

Example #1 Um exemplo simples de ob_get_clean()

<?php

ob_start();

echo "Olá, Mundo!";

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

var_dump($out);
?>

O exemplo acima produzirá:

string(11) "olá, mundo!"

Veja Também

  • ob_start() - Ativa o buffer de saída
  • ob_get_contents() - Retorna o conteúdo do buffer de saída
  • ob_clean() - Limpa (apaga) o conteúdo do buffer de saída ativo
  • ob_end_clean() - Limpa (apaga) o conteúdo do buffer de saída ativo e desliga-o
  • ob_get_flush() - Descarrega (envia) o valor de retorno do manipulador de saída ativo, retorna o conteúdo do buffer de saída ativo e desliga-o