92

Tenho o seguinte código utilizando a função header() do PHP:

header("location: painel.php?spv=nav/regMove");
exit;

e quando ela é acionada reporta o seguinte erro:

Cannot modify header information - headers already sent by

Por que que isto possivelmente ocorre?

0

8 Respostas 8

107

Esse erro deve ser o mais perguntado da história da Internet. Esta resposta é uma tradução de outra mais completa e explicativa originalmente postada no StackOverflow em Inglês feita por um colega de comunidade.

Adicionalmente eu revisei muito da tradução (incluindo gramática) e, obviamente, refiz toda a formatação para o markdown usado no/pelo Stack Overflow. Mas ainda assim, se houver(em) erro(s), sintam-se livres para corrigir ou complementar.


Não emita output antes de enviar os headers!

Funções que enviam/modificam headers HTTP devem ser chamadas antes de que qualquer output seja feito. Caso contrário, a chamada falhará.

Warning: Cannot modify header information - headers already sent (output started at file:line)

Algumas funções que modificam os headers HTTP são:

Output pode ser:

  • Acidental

  • Intencional:

    • print, echo e outras funções que emitem output, como var_dump()
    • Código <html> antes do código dentro de <?php.

Por que isso acontece?

Para entender porque os headers devem ser enviados antes do output, é necessário olhar uma típica HTTP Response. Scripts PHP geram conteúdo HTML principalmente, mas também passam alguns headers HTTP/CGI ao servidor.

HTTP/1.1 200 OK
Powered-By: PHP/5.3.7
Vary: Accept-Encoding
Content-Type: text/html; charset=utf-8

<html><head><title>PHP page output page</title></head>
<body><h1>Content</h1> <p>Some more output follows...</p>
and <a href="/"> <img src=about:note> ...

A página/output sempre segue os headers. O PHP é obrigado a passar os headers ao servidor primeiramente. Ele pode apenas fazer isto uma vez. E depois da quebra de linha dupla (envio de output para simplificar), ele não pode adicionar mais headers.

Quando o PHP recebe o primeiro output (print, echo, ), ele irá enviar os headers coletados. Mais tarde, ele pode enviar todos o conteúdo do output que quiser. Mas, não é possível enviar novos headers a partir deste momento.

Como você pode descobrir onde o output ocorreu?

O warning da função header() contém todas as informações relevantes para localizar a raiz do problema:

Warning: Cannot modify header information - headers already sent by (output started at /www/usr2345/htdocs/auth.php:52) in /www/usr2345/htdocs/index.php on line 100

Aqui, a line 100 refere-se à linha do script onde a chamada da função header() falhou. A mensagem dentro dos parênteses é mais importante. Ela menciona que a linha 52 do arquivo auth.php é a raiz do output. Uma das causas mais populares deste erro são:

Print, echo

Output intencional de execuções print e echo vão acabar com a oportunidade de enviar headers HTTP. O fluxo da aplicação deve ser reestruturado para evitar isso. Use funções e templates. Verifique se as chamadas para a função header() ocorrem antes de que as mensagens são enviadas.

Funções que podem enviar output incluem mas não se limitam a: print, echo, printf(), trigger_error(), vprintf(), ob_flush(), var_dump(), readfile(), passthru(), entre outras. E também funções definidas por você.

Código HTML

Códigos HTML que não são interpretados em um arquivo .php são outputs também. Códigos que chamarão a função header() devem ser feitas antes de qualquer código .

<!DOCTYPE html> <?php // Já não é possível enviar *headers*.

Espaços em branco antes de <?php quando "arquivo.php line 1" é mencionado. Se a mensagem diz que o erro está na linha 1, então é normalmente espaços em branco, texto ou HTML antes da abertura da tag <?php.

 <?php # Há um espaço/linha em branco antes de <?php

Podem igualmente ocorrer com scripts "juntos".

?> <?php

O PHP, na verdade, coloca uma quebra de linha depois de fechar as tags.

UTF-8 BOM

Quebras de linhas e espaços podem ser um problema. Mas também há sequências de caracteres "invisíveis" que podem causar isto. o mais popular é o UTF-8 BOM (Byte-Order-Mark) que não é exibido pela maioria dos editores de texto. É uma sequência de bytes, que é opcional e redundante para arquivos em UTF-8.

Mas o interpretador do PHP o trata como output. Ele também pode mostrar como caracteres  no output (se o cliente interpreta o documento em Latin-1) ou algum "lixo" semelhante.

Particularmente, alguns editores gráficos e IDEs Java-based não notam sua presença. Elas não vêem isso graças ao padrão Unicode. Entretanto, alguns editores e consoles mostram:

inserir a descrição da imagem aqui inserir a descrição da imagem aqui

Não é fácil reconhecer o problema logo no início. Sem um editor desses disponível ou Notepad++ no Windows (que pode resolver o problema), uma outra solução seria um hexeditor. Programadores deveriam ter um, pois eles simplificam a identificação desses problemas:

inserir a descrição da imagem aqui

A solução fácil é definir o editor de texto usado para salvar arquivos como UTF-8 (no BOM) ou alguma outra nomenclatura semelhante ou traduzida. Muitos novos programadores criam novos arquivos por copiar/colar os antigos, apenas alterando seu conteúdo depois.

Utilitários de correção

Há ferramentas automatizadas para reescrever arquivos de texto. Para o PHP, especificamente, há o phptags tag tidier. Ele reescreve tags de abertura e fechamento em tags longas e curtas, mas também resolve facilmente problemas de whitespace e BOM:

phptags --whitespace *.php

É sensato usar em um diretório completo ou no diretório do projeto.

Espaços em branco após ?>

Se a raiz do erro é mencionada depois do fechamento da ?>, então aí é onde há algum espaço em branco ou texto escrito.

A tag de fechamento do PHP não termina a execução do script neste ponto. Quaisquer caracteres depois dela serão impressos como output.

É comumente dito aos novatos que a tag de fechamento deveria ser omitida. Isso evita uma parte significante destes casos. Includes normalmente são os culpados.

Novamente, phptags --whitespace *.php resolve isso rapidamente.

Igualmente, o comando phptags --unclosed ./includes pode remover tags ?> redundantes dos scripts.

Raíz do erro mencionada como "Unknown on line 0"

Acontece tipicamente quando extensões PHP ou o php.ini definem se a raiz do erro não é especificada. Isso acontece principalmente com a gzip stream ou o ob_gzhandler().

Porém, isso também poderia ser qualquer módulo carregado duas vezes, que deixam uma mensagem de warning implícita.

Mensagens de erro anteriores

Se algum outro comando PHP causa um warning ou notice sendo exibida, isso também conta como output. Neste casso, você precisa corrigir o erro, atrasar a execução do comando ou suprimir o erro com isset() ou @ - quando este não obstrui o debugging mais tarde.

Nenhuma mensagem de erro

Se você tem error_reporting ou display_errors desabilitados pelo php.ini, então nenhum warning será exibido. Mas ignorar erros não resolverão o problema (\o/). Mesmo assim, os headers não poderão ser enviados após o output.

Então, quando header("Location: ...") o redirecionamento falha silenciosamente, é bom examinar os warnings. Habilite-os novamente com dois comandos simples (no início do script):

error_reporting(E_ALL); ini_set("display_errors", 1);

Ou se todo o resto falhar:

set_error_handler("var_dump");

Falando de redirecionamentos, você deveria usar algo parecido com isso para caminhos de código no final.

exit(header("Location: /finished.html"));

Ou mesmo uma função, que imprima uma mensagem quando uma chamada header() falhar.

Controle de saída como gambiarra

O controle de saída do PHP é adequado para aliviar este problema. Isso não é tão confiável, mas deveria ser considerado uma gambiarra válida. Seu propósito real é minimizar transferências fragmentadas ao servidor. Reestruturar a aplicação para evitar output é preferível.

Todavia configurar output_buffering ajuda. Configure isso no php.ini ou via .htaccess ou até mesmo .user.ini. Com isso habilitado, o conteúdo fica armazenado em um buffer e não é instantaneamente passado para o servidor. Então headers HTTP podem ser agregados.

Isso pode também ser feito com uma chamada ao ob_start() no topo do script. Isto, entretanto, é menos confiável por algumas razões:

  • Mesmo se <?php ob_start(); ?> começar o primeiro script, espaços em branco ou um problema de BOM podem ser ocasionados antes, tornando está técnica ineficiente.
  • Isso pode ocultar espaços em branco para output HTML; mas na medida em que a lógica da aplicação tenta enviar conteúdo binário (uma imagem gerada, por exemplo), os espaços irrelevantes armazenados no buffer tornam-se um problema. Mesmo que ob_clean() seja uma outra gambiarra válida.
  • O buffer tem um limite de tamanho. Embora geralmente um problema hipotético, pode no entanto acontecer - o que não seria fácil de descobrir/examinar.

Veja também um exemplo básico de uso no manual.

Mas isso funcionou em um outro servidor!?

Se você não teve warnings antes, então a configuração do php.ini mudou. O controle de saída então estava habilitado no outro servidor, mas não no atual. Veja a seção anterior.

Verificando com headers_sent()

Você pode sempre usar headers_sent() para examinar se ainda é possível enviar headers. Isso é útil para condicionalmente mostrar uma informação ou aplicar alguma outra lógica.

if (headers_sent()) {
    die("O redirecionamento falhou. Por favor, clique neste link: <a href=...>");
}
else{
    exit(header("Location: /user.php"));
}

Gambiarra com a tag HTML ☠ ☠ ☠

Se a estrutura da sua aplicação é difícil de corrigir, então uma forma fácil (mas amadora) de criar um redirecionamento é injetando HTML. Um redirecionamento pode ser feito assim:

<meta http-equiv="Location" content="http://example.com/">

Ou com um simples atraso (o sobrinho aprova!):

<meta http-equiv="Refresh" content="2; url=../target.html">

Isso tornará seu site inválido (mesmo com falso XHTML) quando inserido fora do . A maioria dos browsers ainda aceitam isso. Como alternativa, um redirect em Javascript poderia ser feito:

<script> location.replace("target.html"); </script>

É uma abordagem aceitável se este é usado como um fallback pelas funções de redirecionamento especializadas, o qual deveria primeiro tentar enviar um header() propriamente dito, mas usar a meta tag e uma mensagem amigável e um link como último recurso.

Porque setcookie() e session_start() são também afetados

Tanto o setcookie() quanto o session_start() precisam enviar um header Set-Cookie. As mesmas condições portanto se aplicam e mensagens de erros semelhantes serão exibidas.

Problemas de output de headers não são a única causa para a não-funcionalidade com eles, é claro. Cookies desativados no navegador ou até mesmo problemas de proxy deveriam ser sempre verificados. A funcionalidade da session também depende do espaço livre em disco e de outras configurações do php.ini.

Links adicionais

5
  • 4
    um colega de fórum? Quase morri agora :D
    – Jorge B.
    Commented 14/08/2015 às 8:56
  • 3
    Eu estava quase enlouquecendo pois eu queria um simples redirect para a home através de meu script, não importava o caso. Nada funcionava até que o seu exemplo de javascript echo '<script> location.replace("/"); </script>'; resolveu!!! Muito obrigado!!! Commented 20/05/2018 às 21:34
  • 1
    Fico feliz que tenha ajudado :) Commented 21/05/2018 às 14:23
  • 1
    me ajudou demais cara, muito obrigado! Commented 8/07/2018 às 17:35
  • Que resposta ótima ! Commented 27/05/2020 às 4:27
41

A mensagem Cannot modify header information - headers already sent by indica que os headers já foram enviados pelo PHP.

Isto é causado ou por algum código anterior, ou por algum caractere literal que aconteceu antes de você abrir o <?php.

Notar que isto também pode acontecer quando o PHP envia erros ou warnings, então código que dependa de redirect deve sempre suprimir os erros na página e os enviar apenas para um log.

Outra parte das possibilidades já foi explorada na resposta do @Gabriel Santos, e para complementar, caso você tenha mesmo que mudar os headers após a geração de conteúdo, recomendo estudar o Output Buffer do PHP, que permite você "segurar" o conteúdo da página antes de enviar para o cliente.

Notar que a solução mais comum é usar o header() antes de enviar conteúdo. O Output Buffer é uma técnica mais avançada, e só deve ser usado quando realmente for necessário.

Observação: Não tem a ver com o problema mencionado, mas se possível use o endereço completo com http://.. no redirect, para ter a tranquilidade dele funcionar sempre como esperado. É fácil construir o endereço completo usando variáveis $_SERVER.

35

Verifique se não há espaços em branco antes de <?php. Isso porque cabeçalhos (headers) devem ser definidos antes de enviar texto.

Mais uma coisa, se a codificação do arquivo for UTF-8, salve-o sem o BOM (byte order mark). Por exemplo, no Notepad++ você faria assim:

inserir a descrição da imagem aqui

21

Esse tipo de erro geralmente acontece porque o servidor da sua aplicação já começou a enviar o corpo da resposta à requisição HTTP atual. O cabeçalho, que por definição vem antes do corpo, então não pode mais ser enviado.

Numa aplicação PHP, quando isso costuma acontecer?

  • Quando uma mensagem de erro foi emitida antes do output começar (um erro de conexão no banco de dados, um warning do PHP, etc.)
  • Quando um script PHP possui a tag de fechamento "?>", fazendo que o que vem depois dessa tag seja enviado como output
  • Quando o PHP está desatualizado e solta avisos de funções depreciadas, forçando o output

Tente verificar esses pontos que deve resolver.

16

A função header apenas pode ser utilizada antes do script enviar qualquer tipo de resposta ao cliente, pois o header modifica o cabeçalho da resposta HTTP (e este não pode ser modificado depois que se envia algum conteúdo).

Fique atento a funções como echo antes de chamar a função header -- ou se houver conteúdo HTML antes da instrução <?php, pois são o motivo mais comum para este tipo de erro.

13

Eu tive esse mesmo problema, provavelmente você está usando o header() dentro de uma include, pra resolver isso é só colocar ob_start() na index.php no começo do código.

3
  • 3
    Poderia por favor, explicar melhor o que ob_start faz? Commented 10/04/2014 às 18:21
  • 2
    ob_start resolve o problema, mas não serve pra essa finalidade. A melhor forma de resolver esse erro é escrevendo o código corretamente. Ex: Evitar espaços antes da tag de abertura, evitar a tag de fechamento caso o código seja unicamente PHP (para não haver espaços posteriores) e utilizar UTF-8 sem BOM. Commented 9/12/2014 às 13:13
  • Realmente funciona. Commented 4/12/2019 às 2:04
11

Como complemento: O que faz com que muitos programadores sejam surpreendidos com esse erro é que, geralmente, o Xampp (ou até mesmo uma instalação comum entre PHP e Apache) vem com a opção output_buffering marcado como 4096.

A surpresa ocorre porque, no caso dessa opção estar ativa, faz com que haja um efeito similar ao ob_start sendo chamado na primeira linha do código. Ele faz com que o buffer de saída seja iniciado assim que o script é inicializado

Aí, quando "subimos" o sistema para produção, geralmente os servidores vem configurado com a opção output_buffering como Off. Então, o que vai acontecer? Um erro do tipo Warning, que você nunca tinha visto ocorrer em desenvolvimento, vai acontecer no ambiente de produção

Temos então três opção mais simples:

  • Podemos alterar o valor de output_buffering na configuração do PHP em produção, deixando da mesma forma que o ambiente de desenvolvimento (claro, se você tiver acesso a isso no seu servidor).

  • Criarmos o hábito de sempre colocar ob_start no início do código sempre.

  • Desativar o output_buffering em desenvolvimento, já que em produção geralmente vem desativado.

Nos casos acima, a última opção me parece o mais viável. Eu não gosto muito de esconder meus erros debaixo dos panos. Esse erro, como já foi dito, é ocasionado pelo próprio programador, que está tentando definir um header depois que a saída já foi enviada para o cliente.

Limpando o buffer iniciado

Outra forma também que já vi sendo utilizada em frameworks para poder modificar o header depois de já haver conteúdo sendo guardado por ob_start é assim:

while (ob_get_level() > 0) {
    ob_end_clean();
}

O exemplo acima faz com que tudo o buffer de saída seja "esvaziado", o que tornaria possível, por exemplo, a definição de headers com um status http específicos, no caso de uma aplicação com exceptions ou outros tipos de tratamentos de erros.

Veja esse simples exemplo:

<?php ob_start(); ?>

<div> Alguma coisa</div>

<?php
   if (! $usuario->find($id)) {
         throw new Exception('Página não encontrada');
   }

?>

<?php
  set_exception_handler(function($exception)
  {
      // Não deixa sair nada para o browser, senão o exception
      while(ob_get_level() > 0) ob_end_clean();
     
      echo $exception;  
  });

?>
2

Eu estava com o mesmo problema, consegui resolver fazendo o seguinte: Adicione este código no começo:

error_reporting(E_ALL); 
ini_set('display_errors', 'On'); 

Assim vc vai habilitar que a mensagem de erro apareça na tela quando vc enviar o email. Vai aparecer em qual linha do código está acontecendo o output. No meu caso, era um comentário que eu tinha adicionado nas primeiras linhas do código.

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .