array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.headers-sent.php', 1 => 'headers_sent', 2 => 'Verifica se ou onde os cabeçalhos foram enviados', ), 'up' => array ( 0 => 'ref.network.php', 1 => 'Funções de Network', ), 'prev' => array ( 0 => 'function.headers-list.php', 1 => 'headers_list', ), 'next' => array ( 0 => 'function.http-clear-last-response-headers.php', 1 => 'http_clear_last_response_headers', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/network/functions/headers-sent.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

headers_sent

(PHP 4, PHP 5, PHP 7, PHP 8)

headers_sent — Verifica se ou onde os cabeçalhos foram enviados

Descrição

headers_sent(string &$filename = null, int &$line = null): bool

Verifica se ou onde os cabeçalhos foram enviados.

Não é possível adicionar mais linhas de cabeçalho usando a função header() uma vez que o bloco de cabeçalho já tiver sido enviado. Usando esta função, é possível pelo menos evitar mensagens de erro relacionadas ao cabeçalho HTTP. Outra opção é usar Buffer de Saída.

Parâmetros

filename

Se os parâmetros opcionais filename e line forem informados, headers_sent() colocará o nome do arquivo fonte PHP e o número da linha onde a saída iniciou nas variáveis filename e line, respectivamente.

Nota:

Se a saída foi iniciada antes da execução do arquivo fonte PHP (por exemplo, devido a um erro de inicialização), o parâmetro filename será definido como uma string vazia.

line

O número da linha onde a saída iniciou.

Valor Retornado

headers_sent() retornará false se nenhum cabeçalho HTTP ainda tiver sido enviado, ou true caso contrário.

Exemplos

Exemplo #1 Exemplos de uso de headers_sent()

<?php

// Se nenhum cabeçalho tiver sido enviado, envia um
if (!headers_sent()) {
header('Location: http://www.example.com/');
exit;
}

// Um exemplo usando os parâmetros opcionais de arquivo e linha
// Observe que $filename e $linenum são passados para uso posterior.
// Não devem ser atribuídos valores a eles antecipadamente.
if (!headers_sent($filename, $linenum)) {
header('Location: http://www.example.com/');
exit;

// Aqui é exibida uma mensagem de erro.
} else {

echo "Cabeçalhos já enviados no arquivo $filename na linha $linenum\n" .
"Não é possível redirecionar, favor clicar neste atalho: <a " .
"href=\"http://www.example.com\">link</a>\n";
exit;
}

?>

Notas

Nota:

Os cabeçalhos só serão acessíveis e enviados quando uma SAPI que os suporta estiver em uso.

Veja Também