Parse error syntax error no WordPress: como corrigir

Tipo Erro de PHP

Nome do erro Como corrigir Parse error / syntax error no PHP

Severidade Crítico

Descrição O parse error (syntax error) é um erro fatal de PHP que aparece quando há um erro de digitação no código, como uma chave, ponto e vírgula ou parêntese faltando. No WordPress, ele costuma surgir logo após editar o functions.php ou colar um snippet, e derruba a página exata onde o PHP não consegue interpretar o código.

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.

Antes de começar: Faça backup do arquivo antes de editá-lo. Evite o Aparência > Editor de temas para mudanças em PHP: ele salva sem validar e um parse error ali pode derrubar o wp-admin inteiro, exigindo correção via FTP.

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

Erros relacionados

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.

PHP

// 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.php

Perguntas frequentes

O que significa unexpected end of file no parse error?

Significa que o PHP chegou ao fim do arquivo esperando ainda fechar algo: quase sempre uma chave } ou um parêntese ) que ficou aberto. Procure de baixo para cima qual bloco não foi fechado.

Editei o functions.php e travei o site inteiro. Como volto?

Acesse o site via FTP, abra o functions.php no caminho wp-content/themes/seu-tema/ e remova o trecho que você adicionou por último. Salve e recarregue: o site volta sem o código quebrado.

Por que o erro cita uma linha onde parece estar tudo certo?

O PHP aponta onde percebeu o problema, não onde ele começou. Um ponto e vírgula ou uma chave faltando na linha anterior faz o erro aparecer só na linha seguinte. Revise sempre a linha indicada e a de cima.

Aspas curvas podem causar parse error?

Sim. Ao copiar código de um documento do Word ou de um site, as aspas retas viram aspas curvas (inteligentes), que o PHP não reconhece. Reescreva as aspas direto no editor de código para corrigir.

Como vejo o erro se a tela só fica branca?

Ative o WP_DEBUG e o WP_DEBUG_LOG no wp-config.php e abra o wp-content/debug.log. O parse error aparece lá com o arquivo e a linha exatos, mesmo quando a página não mostra nada.

Posso evitar parse error sem mexer em FTP?

Sim, usando um plugin de snippets de código: ele valida a sintaxe antes de ativar e desativa o trecho automaticamente se detectar um erro fatal, sem derrubar o site nem te trancar fora do painel.

Grave

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.

Pro 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.

Pro Grave

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.

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.

Pro Grave

Como corrigir a incompatibilidade do Astra Pro com PHP 8.3

O erro de compatibilidade do Astra Pro com o PHP 8.3 acontece quando uma versão antiga do addon roda num servidor já no PHP 8.3, disparando avisos de deprecated ou um fatal error que derruba o front-end ou o Personalizar. A correção é alinhar tema, plugin Astra Pro e licença na versão mais recente.

Setores

Extensões

Integrações

Como corrigir Parse error / syntax error no PHP

O que é o parse error de sintaxe no PHP?

Como identificar

Como prevenir

Erros relacionados

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir Out of memory no PHP do WordPress

Como corrigir avisos de Deprecated no PHP 8 do WordPress

Como corrigir Allowed memory size exhausted

Como corrigir Headers already sent no WordPress

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

Como corrigir a incompatibilidade do Astra Pro com PHP 8.3

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