Erro: Headers already sent — Cabeçalho já enviado

Tipo Erros fatais

Nome do erro Erro: Headers already sent — Cabeçalho já enviado

Severidade Crítico

Desde WordPress 1.0

Descrição Warning: Cannot modify header information - headers already sent. Impede redirecionamentos e definição de cookies após qualquer saída de texto.

Causa

Algum caractere foi enviado ao browser antes de wp_redirect() ou setcookie() ser chamado. Causas comuns: espaço antes do <?php, BOM no arquivo, echo/print prematuros, ou erros de PHP que geram output.

Como resolver

Garanta que não haja nenhuma saída antes dos headers. Salve arquivos PHP sem BOM (UTF-8 without BOM). Use ob_start() como solução temporária. Ative WP_DEBUG para localizar a origem.

PHP

<?php
// ❌ CAUSA COMUM: espaço ou quebra de linha antes do <?php
//
// Arquivo com espaço antes do <?php:
//   " <?php" ← esse espaço já envia output!

// ✅ SOLUÇÃO 1: Output buffering (temporário)
ob_start();
// ... código que pode gerar output acidentalmente
wp_redirect(home_url('/destino'));
ob_end_clean();
exit;

// ✅ SOLUÇÃO 2: Usar o hook correto para redirecionamentos
add_action('template_redirect', function (): void {
    if (is_page('antiga') && !is_admin()) {
        wp_safe_redirect(home_url('/nova'), 301);
        exit;
    }
});

// ✅ SOLUÇÃO 3: Verificar antes de redirecionar
if (!headers_sent()) {
    wp_redirect(home_url());
    exit;
} else {
    echo '<script>window.location = ' . json_encode(home_url()) . '</script>';
    exit;
}

Erro: Allowed memory size exhausted — Memória PHP esgotada

Fatal error: Allowed memory size of X bytes exhausted. Ocorre quando o PHP tenta alocar mais memória do que o limite configurado no servidor.

Erro: Maximum execution time exceeded — Tempo limite de execução

Fatal error: Maximum execution time of 30 seconds exceeded. Ocorre em scripts longos como importações, processamentos em lote ou loops infinitos.

Erro: Call to undefined function — Função não encontrada

Fatal error: Call to undefined function nome_da_funcao(). Ocorre quando uma função é chamada antes de ser definida ou quando um plugin/tema necessário não está ativo.

Erro: White Screen of Death — Tela branca no WordPress

Página em branco sem qualquer erro visível. Geralmente indica um erro PHP fatal que está sendo suprimido pela configuração de exibição de erros do servidor.

Parse error: syntax error — Erro de sintaxe no WordPress

Erro de sintaxe PHP que impede o carregamento do site. Ocorre quando um comando não é escrito corretamente no código.

Pro

Erro: Allowed memory size exhausted — Memória esgotada

Fatal error: Allowed memory size of X bytes exhausted. Ocorre quando o PHP tenta alocar mais memória do que o limite configurado.