PHP マニュアル
前のページ		次のページ

CXIII. 出力制御関数(output control)

導入

出力制御関数により、スクリプトから送信される出力を制御することが可能になります。この機能は、複数の異なった場面、特にスクリプトがデータ出力を開始した後にヘッダをブラウザに送信する必要がある場合に有用です。出力制御関数は、 header() または setcookie() を使用して送信されたヘッダには作用せず、 echo() のような関数とPHPコードのブロック間のデータにのみ作用します。

注意: PHP 4.1 (および4.2)から4.3に更新する際、前のバージョンのバグのせいで、php.ini のimplict_flush を OFF にする必要があります。さもないと、 ob_start() を使用する全ての出力は、出力を抑制することができなくなります。

要件

外部ライブラリを必要としません。

インストール手順

PHP コアに含まれるため、追加のインストール無しで使用できます。

実行時設定

php.ini の設定により動作が変化します。

表 1. 出力制御設定オプション

名前	デフォルト	変更の可否	変更履歴
output_buffering	"0"	PHP_INI_PERDIR
output_handler	NULL	PHP_INI_PERDIR	PHP 4.0.4 以降で使用可能です。
implicit_flush	"0"	PHP_INI_ALL	PHP <= 4.2.3 では PHP_INI_PERDIR です。

PHP_INI_* 定数の詳細および定義については付録G を参照してください。

以下に設定ディレクティブに関する簡単な説明を示します。

output_buffering boolean / integer

このディレクティブを 'On' と設定することにより、全てのファイルに関して出力バッファリングを有効にすることができます。特定の大きさにバッファの大きさを制限したい場合、このディレクティブの値として 'On' の代わりに最大バイト数(例:output_buffering=4096) を使用することができます。 PHP 4.3.5 以降、PHP-CLI ではこのディレクティブが常に Off となります。

output_handler string

スクリプトの全ての出力を関数にリダイレクトすることができます。例えば、output_handler に mb_output_handler() を指定した場合、文字エンコーディングは透過的に指定したエンコーディングに変換されます。出力ハンドラを指定することにより自動的に出力バッファリングを on にします。

注意: ob_iconv_handler() と mb_output_handler() の両方で使用することはできません。また、 ob_gzhandler() と zlib.output_compression の両方を使用することはできません。

注意: このディレクティブには、組み込み関数のみが使用可能です。ユーザ定義の関数については、 ob_start() を使用してください。

implicit_flush boolean

デフォルトは FALSE です。これを TRUE に変更すると、PHP が各出力ブロックの後で自動的に出力レイヤをフラッシュするよう指定します。これは、各 print() および HTML ブロックの後で flush() 関数をコールすることと等価です。

Web 環境の中で PHP を使用している時にこのオプションを on に変更すると、著しい性能低下が生じるため、通常はデバッグ目的のみにすることが推奨されます。CLI SAPI のもとで実行される時、この値はデフォルトで TRUE になっています。

ob_implicit_flush() も参照ください。

リソース型

リソース型は定義されていません。

定義済み定数

定数は定義されていません。

例

例 1. 出力制御の例



 
<?php



ob_start

();

echo 

"Hello\n"

;





setcookie

(

"cookiename"

, 

"cookiedata"

);





ob_end_flush

();





?>

上記の例では、 echo() からの出力は、 ob_end_flush() がコールされるまで出力バッファに保存されます。この際、 setcookie() をコールするとエラーを発生することなくクッキーが保存されます。(通常、データの送信後はブラウザにヘッダを送信することはできません。)

参考

header() および setcookie() も参照ください。

目次
flush -- 出力バッファをフラッシュする
ob_clean -- 出力バッファをクリア(消去)する
ob_end_clean -- 出力用バッファをクリア(消去)し、出力のバッファリングをオフにする
ob_end_flush -- 出力用バッファをフラッシュ(送信)し、出力のバッファリングをオフにする
ob_flush -- 出力バッファをフラッシュ(送信)する
ob_get_clean -- 現在のバッファの内容を取得し、出力バッファを削除する
ob_get_contents -- 出力用バッファの内容を返す
ob_get_flush -- 出力バッファをフラッシュし、その内容を文字列として返した後で出力バッファリングを終了する
ob_get_length -- 出力バッファの長さを返す
ob_get_level -- 出力バッファリング機構のネストレベルを返す
ob_get_status -- 出力バッファのステータスを取得する
ob_gzhandler -- 出力バッファを gzip 圧縮するための ob_start コールバック関数
ob_implicit_flush -- 自動フラッシュをオンまたはオフにする
ob_list_handlers -- 使用中の出力ハンドラの一覧を取得する
ob_start -- 出力のバッファリングを有効にする
output_add_rewrite_var -- URL リライタの値を追加する
output_reset_rewrite_vars -- URL リライタの値をリセットする

前のページ	ホーム	次のページ
PDO_OCI DSN	上に戻る	flush