ob_get_status

(PHP 4 >= 4.2.0, PHP 5)

ob_get_status --  Get status of output buffers

Description

array ob_get_status ( [bool full_status=FALSE] )

ob_get_status() returns status information on either the top level output buffer or all active output buffer levels if full_status is set to TRUE.

If called without the full_status parameter or with full_status = FALSE a simple array with the following elements is returned:

Example 1. Simple ob_get_status() output

Array
(
    [level] => 2
    [type] => 0
    [status] => 0
    [name] => URL-Rewriter
    [del] => 1
)

Simple ob_get_status() results

Key: level

Value: Output nesting level

Key: type

Value: PHP_OUTPUT_HANDLER_INTERNAL (0) or PHP_OUTPUT_HANDLER_USER (1)

Key: status

Value: One of PHP_OUTPUT_HANDLER_START (0), PHP_OUTPUT_HANDLER_CONT (1) or PHP_OUTPUT_HANDLER_END (2)

Key: name

Value: Name of active output handler or ' default output handler' if none is set

Key: del

Value: Erase-flag as set by ob_start()

If called with full_status = TRUE an array with one element for each active output buffer level is returned. The output level is used as key of the top level array and each array element itself is another array holding status information on one active output level.

Example 2. Full ob_get_status() output

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
        )

)

The full output contains these additional elements:

Full ob_get_status() results

Key: chunk_size

Value: Chunk size as set by ob_start()

Key: size

Value: ...

Key: blocksize

Value: ...

See also ob_get_level() and ob_list_handlers().