ob_get_status

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

ob_get_status — Obtém status dos buffers de saída

Descrição

ob_get_status(bool $full_status = false): array

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.

Parâmetros

full_status

true para retornar todos os níveis de buffers de saída ativos. Se for false ou não definido, somente o buffer de saída de nível mais alto é retornado.

Valor Retornado

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.

Elementos do array de retorno de ob_get_status()
ChaveValor
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())

Exemplos

Example #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
)

Example #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
        )

)

Veja Também