ob_get_clean

アクティブな出力バッファの内容を取得し、そのバッファをオフにする

stringfalse ob_get_clean()

この関数は、 (PHP_OUTPUT_HANDLER_CLEAN と PHP_OUTPUT_HANDLER_FINAL フラグを指定して) 出力ハンドラをコールし、その戻り値を破棄するとともに、アクティブな出力バッファの内容を返しつつ、かつそれをオフにします。

PHP_OUTPUT_HANDLER_REMOVABLE を指定してアクティブな出力バッファを開始しないと、 ob_get_clean は失敗します。

ob_get_clean は、PHP_OUTPUT_HANDLER_CLEANABLE を指定せずにアクティブな出力バッファを開始したとしても、そのバッファの内容をクリアします。

この関数にはパラメータはありません。

成功した場合、アクティブな出力バッファの内容を返します。失敗した場合は、false を返します。

警告

アクティブな出力バッファがない場合、　ob_get_clean は false を返しますが E_NOTICE は発生しません。

この関数が失敗すると、 E_NOTICE が発生します。

例1 単純な ob_get_clean の例


<?php

ob_start();

echo "Hello World";

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

var_dump($out);
?>

上の例の出力は以下となります。


string(11) "hello world"