Como corrigir Parse error / syntax error no PHP
O que é o parse error de sintaxe no PHP?
O parse error syntax error no WordPress é o erro que o PHP emite quando não consegue interpretar o código por causa de uma falha de sintaxe: falta uma chave, um ponto e vírgula, um parêntese ou há um caractere inesperado. Como o PHP nem chega a executar o arquivo, ele para na hora e mostra exatamente o arquivo e a linha onde travou. Quase sempre é resultado de uma edição manual recente no functions.php ou em outro arquivo PHP.
Como identificar
- Mensagem “Parse error: syntax error, unexpected ‘…’ in /caminho/arquivo.php on line N”, citando o arquivo e a linha.
- Variações como “unexpected end of file”, “unexpected ‘}'”, “unexpected token” ou “unexpected ‘<‘”.
- O erro aparece imediatamente após editar o functions.php, colar um snippet ou salvar um arquivo no editor de temas.
- O site (ou só o wp-admin) fica travado mostrando apenas a linha do erro, sem o resto da página.
Como prevenir
- Edite arquivos PHP só via FTP ou plugin de snippets (que valida), nunca pelo editor de temas do painel
- Rode ‘php -l arquivo.php’ ou um lint no editor antes de subir qualquer alteração
- Cole snippets de fontes confiáveis e confira se a tag <?php não está duplicada
Causa
- Ponto e vírgula faltando no fim de uma instrução PHP.
- Chave { ou parêntese ( aberto e não fechado (gera 'unexpected end of file').
- Snippet colado com a tag de abertura do PHP duplicada ou colado dentro de um bloco já aberto.
- Aspas não fechadas ou aspas inteligentes (curvas) copiadas de um editor de texto em vez de aspas retas.
- Edição direta no editor de temas do painel (Aparência, Editor de temas) que salvou o arquivo já quebrado.
Como resolver
- Leia o arquivo e a linha do erro: a mensagem diz o caminho exato e a linha (ex.: functions.php on line 142). Abra esse arquivo via FTP ou no gerenciador de arquivos da hospedagem.
- Reverta a última edição: se o erro surgiu após colar um snippet, apague o trecho que você adicionou por último. O código que estava funcionando antes volta a rodar.
- Corrija a sintaxe na linha indicada: verifique na linha do erro (e na anterior) se falta ponto e vírgula, chave, parêntese ou aspas. 'unexpected end of file' quase sempre é uma chave } que faltou fechar.
- Valide o código antes de salvar: se tiver acesso a SSH, rode a checagem de sintaxe do PHP antes de subir o arquivo:
php -l wp-content/themes/seu-tema/functions.php - Nunca edite pelo editor do painel: edite arquivos PHP só por FTP ou por um plugin de snippets, que valida o código. O editor de temas do wp-admin salva o arquivo quebrado e pode te trancar fora do site.
// EXEMPLO de parse error — falta o ponto e virgula no fim da linha
add_filter( 'the_content', 'meu_callback' ) // <- ERRO: faltou ;
// CORRETO — instrucao fechada com ponto e virgula
add_filter( 'the_content', 'meu_callback' );
// Validacao por linha de comando (SSH), sem abrir o navegador:
// php -l wp-content/themes/seu-tema/functions.phpPerguntas frequentes
O que significa unexpected end of file no parse error?
Editei o functions.php e travei o site inteiro. Como volto?
Por que o erro cita uma linha onde parece estar tudo certo?
Aspas curvas podem causar parse error?
Como vejo o erro se a tela só fica branca?
Posso evitar parse error sem mexer em FTP?
Como atualizar a versão do PHP no WordPress com segurança
Atualizar a versão do PHP do WordPress deixa o site mais rápido e seguro, mas plugins ou temas antigos podem quebrar na versão nova. O caminho seguro é testar em uma cópia, conferir a compatibilidade e só então trocar a versão no painel da hospedagem, com como reverter à mão.
Como corrigir Undefined array key no PHP 8 do WordPress
O Undefined array key é um aviso do PHP 8 que aparece quando o código tenta ler uma posição de um array que não existe, por exemplo um campo de formulário que não foi enviado. O site segue no ar, mas a mensagem aparece na tela ou enche o debug.log e indica que falta uma verificação no código.
Como corrigir Headers already sent no WordPress
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.
Como corrigir Out of memory no PHP do WordPress
O erro out of memory no PHP do WordPress acontece quando um processo tenta alocar mais memória do que o limite do PHP ou a RAM do servidor têm disponível, e a execução para na hora. Costuma ser disparado por loops, consultas gigantes ou processos concorrentes em um servidor pequeno.
Como corrigir Failed opening required no WordPress
O Failed opening required é um erro fatal de PHP que aparece quando o código manda incluir um arquivo (com require) que não existe no caminho informado, está com permissão negada ou foi apagado. O WordPress para na hora e a página não abre, geralmente após uma migração, uma atualização interrompida ou um plugin removido pela metade.
Como corrigir Uncaught Error: Class not found
O erro Class not found é um erro fatal de PHP que aparece quando o código instancia uma classe que não foi carregada na execução. No WordPress, surge quando um plugin atualizado pela metade, um autoload do Composer ausente ou um arquivo de classe apagado impedem o PHP de encontrar a definição.
