(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
ob_get_status — Obtém status dos buffers de saída
ob_get_status() retorna informação de status do
buffer de saída do nível mais alto ou de todos os níveis de buffers de saída ativos se
full_status estiver definido para true.
Se full_status for omitido ou false um array simples
contendo informações de status no nível de saída ativo é retornado.
Se full_status for true um array
com um elemento para cada nível de buffer de saída ativo é retornado.
O nível de saída é usado como chave do array de nível superior e cada elemento
do array em si é outro array que contém informações de status
sobre um nível de saída ativo.
Um array vazio será retornada se o buffer de saída não estiver ativado.
| Chave | Valor |
|---|---|
| name | Nome do manipulador de saída ativo (veja os valores de retorno de ob_list_handlers() para detalhes) |
| type |
0 (manipulador interno) ou
1 (manipulador fornecido pelo usuário)
|
| flags |
Máscara de bits das opções definidas por ob_start(),
o tipo de manipulador de saída (veja acima)
e o status do processo de buffer
(constantes
PHP_OUTPUT_HANDLER_*
).
Se o manipulador processou o buffer com sucesso e não retornou false,
PHP_OUTPUT_HANDLER_STARTED e
PHP_OUTPUT_HANDLER_PROCESSED serão definidas.
Se o manipulador falhou ao processar o buffer ou retornou false,
PHP_OUTPUT_HANDLER_STARTED e
PHP_OUTPUT_HANDLER_DISABLED serão definidas.
|
| level |
Nível de aninhamento de saída (com base em zero). Observe que o valor retornado para o
mesmo nível por ob_get_level() está deslocado em uma unidade.
O primeiro nível é 0 para ob_get_status()
e 1 para ob_get_level().
|
| chunk_size | Tamanho do bloco em bytes. Definido por ob_start() ou se output_buffering estiver habilitado e seu valor estiver definido como um número inteiro positivo. |
| buffer_size | Tamanho do buffer de saída em bytes |
| buffer_used | Tamanho dos dados no buffer de saída em bytes (o mesmo que o valor de retorno do tipo inteiro de ob_get_length()) |
Exemplo #1 Array retornado quando full_status é false
Array
(
[name] => URL-Rewriter
[type] => 0
[flags] => 112
[level] => 2
[chunk_size] => 0
[buffer_size] => 16384
[buffer_used] => 1024
)
Exemplo #2 Array retornado quando full_status é 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
)
)
The fields inside the array returned by ob_get_status() are:
Array
(
[name] => default output handler
[type] => 0
[flags] => 112
[level] => 1
[chunk_size] => 0
[buffer_size] => 16384
[buffer_used] => 0
)
These values are filled just after the function ob_start()