Headers already sent no WordPress: como corrigir

Tipo Erro de PHP

Nome do erro Headers already sent EN: Headers already sent

Severidade Grave

Descrição O headers already sent é um erro de PHP que aparece quando o WordPress tenta enviar um cabeçalho HTTP (um redirecionamento, um cookie de login) depois que algum conteúdo já foi enviado ao navegador. A causa quase sempre é um espaço em branco ou um echo antes ou depois das tags do PHP em um arquivo como o wp-config.php ou o functions.php.

O que é o erro Headers already sent?

O headers already sent no WordPress é o aviso que o PHP emite quando uma função como header(), setcookie() ou um redirecionamento é chamada depois que o servidor já começou a enviar o corpo da página. No HTTP os cabeçalhos vêm antes do conteúdo, então qualquer caractere enviado cedo demais (um espaço, uma linha em branco, um BOM ou um echo) trava o envio dos cabeçalhos. A mensagem informa exatamente o arquivo e a linha onde a saída começou, o que aponta o culpado.

Como identificar

Mensagem “Warning: Cannot modify header information – headers already sent by (output started at /caminho/arquivo.php:N)”, citando onde a saída começou.
O login do wp-admin não persiste: você entra e é deslogado, porque o cookie de sessão não consegue ser definido.
Redirecionamentos param de funcionar e a página mostra o aviso no topo, antes do resto do conteúdo.
O erro surge logo após editar o wp-config.php ou o functions.php, ou após instalar um plugin que adiciona código a esses arquivos.

Antes de começar: Faça backup do arquivo antes de editar. Edite o wp-config.php e o functions.php só via FTP ou pelo gerenciador de arquivos da hospedagem, com um editor que mostre espaços e quebras de linha. O editor de temas do painel não evidencia espaços em branco e pode reintroduzir o erro.

Como prevenir

Em arquivos só de PHP, nunca inclua a tag de fechamento no final
Configure o editor de código para salvar sempre como UTF-8 sem BOM
Evite deixar echo, print ou var_dump de depuração no código que vai para produção

Causa

Espaço em branco ou linha em branco antes da tag de abertura do PHP no início do arquivo.
Espaço ou linha em branco depois da tag de fechamento do PHP no fim do wp-config.php ou do functions.php.
Arquivo salvo com BOM (Byte Order Mark) UTF-8, que envia bytes invisíveis antes de qualquer cabeçalho.
Um echo, print ou var_dump deixado no código que envia conteúdo antes do redirecionamento ou do cookie.
Plugin ou tema que imprime aviso de erro (notice) na tela antes do WordPress definir os cabeçalhos.

Como resolver

Leia o arquivo e a linha do output: a mensagem traz 'output started at /caminho/arquivo.php:N'. Esse é o arquivo e a linha onde a saída indevida começou. Abra-o via FTP.
Remova espaços antes da abertura do PHP: garanta que o arquivo comece exatamente na tag de abertura, sem nenhum caractere, espaço ou linha em branco antes dela.
Remova a tag de fechamento no fim: em arquivos só de PHP como wp-config.php e functions.php, apague a tag de fechamento do final. Sem ela, nenhum espaço acidental depois dela pode ser enviado ao navegador.
Salve o arquivo sem BOM: no seu editor de código, escolha salvar como UTF-8 sem BOM. O BOM adiciona bytes invisíveis no começo do arquivo que disparam o erro.
Procure echo e var_dump esquecidos: se o output vier de um plugin ou snippet, busque por echo, print ou var_dump deixados no código e remova-os.

PHP

<?php
// CERTO: a tag de abertura e o primeiro caractere do arquivo, sem espaco antes.
// Em arquivos so de PHP (wp-config.php, functions.php), NAO inclua a tag de
// fechamento no fim. Assim nenhum espaco acidental depois dela vira output.

define( 'WP_DEBUG', false );

// fim do arquivo: sem tag de fechamento, sem linha em branco extra apos isto

Perguntas frequentes

O que significa output started at no aviso?

É o ponto exato onde algum conteúdo começou a ser enviado ao navegador antes dos cabeçalhos: o aviso cita o arquivo e a linha. Quase sempre é um espaço em branco antes da abertura do PHP ou depois do fechamento naquele arquivo.

Por que o login do wp-admin não persiste com esse erro?

Porque o cookie de sessão é um cabeçalho HTTP. Se a saída já começou, o WordPress não consegue definir o cookie e você é deslogado a cada navegação. Corrigir o espaço em branco que dispara o erro resolve o login.

Como o BOM causa headers already sent?

O BOM é uma sequência de bytes invisíveis que alguns editores adicionam no início de arquivos UTF-8. Esses bytes contam como saída e são enviados antes dos cabeçalhos. Salve o arquivo como UTF-8 sem BOM para eliminar a causa.

Devo apagar a tag de fechamento do PHP mesmo?

Em arquivos que contêm apenas PHP, sim. Omitir a tag de fechamento é a recomendação dos padrões de código do WordPress justamente para evitar que espaços ou quebras de linha após ela sejam enviados ao navegador.

O erro cita um plugin. Como corrijo sem editar o plugin?

Desative o plugin via FTP renomeando a pasta dele para confirmar que é a causa. Se for, atualize-o ou contate o desenvolvedor: editar o arquivo do plugin é sobrescrito na próxima atualização.

Posso resolver sem FTP?

Em geral não, porque o arquivo que precisa ser limpo costuma ser o wp-config.php ou o functions.php, fora do alcance do painel quando o erro já trava o login. O caminho seguro é editar via FTP ou pelo gerenciador de arquivos da hospedagem.

Atenção

Como corrigir avisos de Deprecated no PHP 8 do WordPress

Os avisos de Deprecated no PHP 8 aparecem quando um plugin ou tema usa um recurso da linguagem que ainda funciona, mas foi marcado para remoção em versões futuras. Não derrubam o site, mas poluem a tela e os logs e indicam código desatualizado que pode quebrar de vez em um PHP mais novo.

Grave

Como corrigir Allowed memory size exhausted

O erro allowed memory size exhausted é um erro fatal de PHP que aparece quando um script do WordPress tenta usar mais memória do que o limite definido no servidor. O resultado é uma página em branco ou um aviso de erro fatal, geralmente disparado por um plugin pesado, importação de dados ou limite memory_limit baixo demais.

Grave

Como corrigir a incompatibilidade do Tutor LMS com PHP 8.3

A incompatibilidade do Tutor LMS com PHP 8.3 acontece quando uma versão do plugin escrita para PHP 7.4 roda num servidor já no PHP 8.3, gerando avisos de Deprecated e, em alguns casos, erro fatal ao salvar cursos ou abrir o construtor de quiz. A documentação oficial homologa o plugin a partir do PHP 7.4.

Informativo

Como ativar o modo de depuração (WP_DEBUG)

O WP_DEBUG é a constante do WordPress que liga o modo de depuração e faz o PHP exibir ou registrar os erros, avisos e notices que normalmente ficam escondidos. Ativá-lo é o primeiro passo para diagnosticar tela branca, erro fatal e conflitos de plugin, porque revela o arquivo e a linha exatos da falha.

Grave

Como corrigir Call to undefined function no WordPress

O Call to undefined function é um erro fatal de PHP que aparece quando o código chama uma função que não existe naquele ponto: ou o nome está errado, ou a extensão que a fornece está desativada, ou a função do WordPress foi chamada cedo demais. O site cai com erro fatal na página afetada.

Grave

Como corrigir Cannot redeclare function

O erro Cannot redeclare function é um erro fatal de PHP que ocorre quando a mesma função é definida duas vezes na execução. No WordPress, costuma surgir ao colar um snippet repetido no functions.php ou ao ativar dois plugins que declaram uma função com o mesmo nome.

Setores

Extensões

Integrações

Como corrigir Headers already sent no WordPress

O que é o erro Headers already sent?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir avisos de Deprecated no PHP 8 do WordPress

Como corrigir Allowed memory size exhausted

Como corrigir a incompatibilidade do Tutor LMS com PHP 8.3

Como ativar o modo de depuração (WP_DEBUG)

Como corrigir Call to undefined function no WordPress

Como corrigir Cannot redeclare function

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos