ob_get_status
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
ob_get_status — Lee el estado del búfer de salida
Parámetros
full_status
-
true
para devolver todos los búferes de salida. Si es false
o no está definido, solo se devolverá el estado del búfer de salida de alto nivel.
Valores devueltos
Si el parámetro full_status
está omitido o es igual a false
, se devuelve un array simple
que contiene información sobre el estado del nivel de salida activo.
Si el parámetro full_status
es igual a true
, se devuelve un array
con un elemento para cada nivel de búfer de salida activo. El nivel de salida se utiliza como clave del array superior y cada elemento del array
es a su vez otro array que contiene información sobre un nivel de salida activo.
Se devuelve un array vacío si la memoria intermedia de salida no está activada.
Elementos devueltos por la función ob_get_status()
Clave | Valor |
---|
name |
Nombre del gestor de salida activo (ver los valores de retorno de
ob_list_handlers() para más detalles)
|
type |
0 (gestor interno) o
1 (gestor proporcionado por el usuario)
|
flags |
Máscara de bits de los indicadores definidos por la función ob_start(),
el tipo de gestor de salida (ver arriba)
y el estado del proceso de memoria intermedia
(
PHP_OUTPUT_HANDLER_*
constantes).
Si el gestor ha procesado con éxito el búfer y no ha devuelto false ,
PHP_OUTPUT_HANDLER_STARTED y
PHP_OUTPUT_HANDLER_PROCESSED estarán definidos.
Si el gestor ha fallado al procesar el búfer o ha devuelto false ,
PHP_OUTPUT_HANDLER_STARTED y
PHP_OUTPUT_HANDLER_DISABLED estarán definidos.
|
level |
Nivel de anidación de la salida (a partir de cero). Tenga en cuenta que el valor devuelto para
el mismo nivel por la función ob_get_level() está desplazado en uno.
El primer nivel es 0 para ob_get_status(),
y 1 para ob_get_level().
|
chunk_size |
Tamaño del fragmento en bytes. Definido por la función ob_start()
o output_buffering si está activado
y su valor está definido como un entero positivo
|
buffer_size |
Tamaño del búfer de salida en bytes
|
buffer_used |
Tamaño de los datos en el búfer de salida en bytes
(el mismo que el valor de retorno entero de ob_get_length())
|
Ejemplos
Ejemplo #1 Array devuelto cuando el parámetro full_status
es igual a true
Array
(
[type] => 0
[flags] => 112
[level] => 2
[chunk_size] => 0
[buffer_size] => 16384
[buffer_used] => 1024
)
Ejemplo #2 Array devuelto cuando el parámetro full_status
es igual a true
Array
(
[0] => Array
(
[name] => default output handler
[type] => 0
[flags] => 112
[level] => 1
[chunk_size] => 0
[buffer_size] => 16384
[buffer_used] => 2048
)
[1] => Array
(
[name] => URL-Rewriter
[type] => 0
[flags] => 112
[level] => 2
[chunk_size] => 0
[buffer_size] => 16384
[buffer_used] => 1024
)
)