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

function 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()**
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())

Exemplos

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
        )

)

Veja Também

ob_get_level() - Retorna o nível de aninhamento do mecanismo de buffer de saída
ob_list_handlers() - Lista todos os manipuladores de saída em uso
ob_get_length() - Retorna o comprimento do buffer de saída
ob_start() - Ativa o buffer de saída

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicionar nota

Notas de Usuários 1 note

down

rmagalhaess at hotmail dot com ¶

8 years ago

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()

＋adicionar nota