ob_get_status
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
ob_get_status — 出力バッファのステータスを取得する
説明
array ob_get_status
([ bool
$full_status = FALSE
] )
ob_get_status() は、トップレベルの出力バッファの
ステータス情報を返します。full_status が
TRUE に設定されている場合は、すべてのアクティブな出力バッファの
ステータス情報を返します。
パラメータ
-
full_status -
TRUEを指定すると、すべてのアクティブな出力バッファを返します。FALSEを指定した場合、あるいは省略した場合は、 トップレベルの出力バッファのみを返します。
返り値
パラメータ full_status を指定していなかったり
full_status = FALSE としていた場合は、
以下の要素を保持する配列が返されます。
Array
(
[level] => 2
[type] => 0
[status] => 0
[name] => URL-Rewriter
[del] => 1
)
| キー | 値 |
|---|---|
| level | 出力階層レベル |
| type | PHP_OUTPUT_HANDLER_INTERNAL (0) あるいは PHP_OUTPUT_HANDLER_USER (1) |
| status | PHP_OUTPUT_HANDLER_START (0)、PHP_OUTPUT_HANDLER_CONT (1) あるいは PHP_OUTPUT_HANDLER_END (2) のいずれか |
| name | アクティブな出力ハンドラの名前、あるいは設定されていない場合は ' default output handler' |
| del | ob_start() が設定した削除フラグ |
full_status = TRUE を指定してコールした場合、
出力バッファごとにひとつの要素を保持する配列が返されます。
出力レベルが配列のキーとして使用され、対応する値として
各出力レベルのステータス情報を配列として保持します。
Array
(
[0] => Array
(
[chunk_size] => 0
[size] => 40960
[block_size] => 10240
[type] => 1
[status] => 0
[name] => default output handler
[del] => 1
)
[1] => Array
(
[chunk_size] => 0
[size] => 40960
[block_size] => 10240
[type] => 0
[buffer_size] => 0
[status] => 0
[name] => URL-Rewriter
[del] => 1
)
)
完全な出力には、追加項目として以下の要素が含まれます。
| キー | 値 |
|---|---|
| chunk_size | ob_start() で設定したチャンクの大きさ |
| size | ... |
| blocksize | ... |
忘却曲線を使ってこの関数を確実に記憶に残す
