Como corrigir o “erro de análise: erro de sintaxe inesperado” no WordPress

Se você já atualizou um plugin ou código colado em seu site do WordPress, é provável que você tenha visto o erro de análise de sintaxe final inesperado na mensagem do WordPress. Este é um erro comum porque leva apenas um caractere para causá-lo. Neste artigo, exploraremos o que causa esse erro e veremos como corrigi-lo.

O que significa erro de análise: erro de sintaxe, fim inesperado no WordPress?

Erro de análise de sintaxe, erro final inesperado no WordPress pode ser o mais simples dos erros e ainda causar um grande problema.

O erro tem duas partes:

Erro de sintaxe - Este erro é causado por um erro na estrutura do PHP quando um caractere está faltando ou adicionado que não deveria estar lá.

Inesperado - significa que falta um caractere no código e que o PHP chega ao final do arquivo sem encontrar o que está procurando. O erro incluirá informações no final que explicam o que viu de inesperado.

Se você vir Erro de análise: Erro de sintaxe, Fim inesperado no WordPress, isso significa apenas que o WordPress detectou que algo está faltando ou foi adicionado no código. Pode ser algo tão simples como uma vírgula, ponto e vírgula, um parêntese de fechamento ou muitos colchetes.

A sintaxe ausente pode estar dentro do código que você escreveu ou colou no seu site, ou dentro de um tema ou plugin que você instalou ou atualizou.

Felizmente, não é tão difícil de encontrar e consertar. No entanto, você precisará entender como o código funciona e como editá-lo.

Como resolver o erro de análise: Erro de sintaxe Fim inesperado no WordPress

O final inesperado do erro de sintaxe do erro de análise real no WordPress terá um final diferente dependendo do que está causando o erro.

Exemplos incluem:

• 1) erro de sintaxe, final de arquivo inesperado
• 2) erro de sintaxe, token inesperado
• 3) erro de sintaxe, variável inesperada
• 4) erro de sintaxe, identificador inesperado

A mensagem de erro geralmente identificará o token específico, variável, identificador, etc., que ela não gosta. Veremos alguns exemplos disso conforme prosseguirmos.

Testando o erro de análise Erro de sintaxe Fim inesperado no WordPress

O WordPress fez muitas melhorias na forma como lida com o código. Agora, em vez de executar um código incorreto e matar seu site, se ele tiver uma versão anterior do código executado, ele tenta usar esse código ao exibir o site aos visitantes.

Isso evita que seu site exiba o erro aos visitantes e evita que você seja bloqueado. Ainda é possível que seu site seja desativado e bloqueie você, mas agora é mais difícil.

Além disso, os editores de código agora mostram marcação, portanto, é fácil identificar variáveis ​​e outros elementos de código. Isso torna mais fácil testar o código no plugin e nos editores de código do tema no WordPress.

Infelizmente, o WordPress nem sempre fornece uma mensagem clara. Às vezes, não há mensagem, falta conteúdo ou simplesmente não mostra o site. Tudo isso pode ser consertado, mas pode levar um pouco mais de solução de problemas.

Vejamos alguns exemplos. Começaremos com algo fácil.

Editando Código de Plugin

Primeiro, comece com o que você fez por último. Neste exemplo, editei o código em um arquivo de plug-in. O arquivo foi revertido para o último código válido conhecido, portanto, minhas alterações não estão funcionando. Veja o erro. Ele dirá o que está causando o código de erro e a linha de código com o erro.

Neste exemplo, o WordPress está vendo um colchete inesperado quando espera ver um ponto e vírgula.

Este é simples. Primeiro, olhe para a linha acima dela. Vemos a palavra quebra , terminando o caso 4 . Temos sorte de termos outros casos para comparar. Acima está o caso 3 , que também termina com quebra , mas este tem um ponto e vírgula de fechamento.

Em seguida, edite o código que causou o erro.

Aqui está outro exemplo no mesmo arquivo de plug-in. Este está mostrando o erro na linha 488. No entanto, essa linha de código está correta. Mas está me dando uma pista. É identificar isso como uma variável inesperada.

Se olharmos para o código acima 488, vemos que falta um colchete de fechamento. Isso faz com que o WordPress veja a próxima linha incorretamente.

Basta adicionar o colchete de fechamento e atualizar o arquivo. O código agora funciona corretamente.

Esses problemas eram simples, mas na maioria das vezes você vê um erro de sintaxe de análise final inesperado no WordPress, é exatamente como esses exemplos.

Corrigindo o erro de análise quando você não consegue encontrar o erro

Há duas maneiras de localizar o erro de análise, se ele não for exibido para você ou se você não tiver certeza de onde ele está vindo. Aqui está uma olhada em ambos os métodos.

Modo de depuração

A primeira etapa é habilitar o log de erros do WordPress. Vá para o seu arquivo wp-config usando FTP ou cPanel. Procure uma linha de código semelhante a esta:

define( 'WP_DEBUG', false );

Se você tiver esse código, altere falso para verdadeiro.

Se você não tem esta linha de código, procure uma linha que diz:

“Pare de editar! Feliz blogging. ” e cole este código:

define( 'WP_DEBUG', true );

Carregue o site. Isso exibirá o erro e agora você tem um lugar para começar a solução de problemas.

Plugin de depuração

O Query Monitor é um dos plug-ins de depuração mais populares. Ele fornece ferramentas que você pode acessar pelo front-end e back-end da barra de menu superior e como uma sobreposição.

Isso habilitará várias ferramentas de depuração, incluindo um log de erros onde você pode encontrar as informações de que precisa.

Corrigindo o erro de análise se você estiver bloqueado no WordPress

Se você não tiver acesso ao painel de administração, precisará fazer as alterações de outra maneira. Você precisará baixar o arquivo do servidor que contém o erro e abri-lo em um editor de código para fazer suas edições.

No meu caso, eu estava fazendo alterações no arquivo functions.php para o tema Twenty Twenty One. Eu cometi um erro na minha sintaxe e meu site caiu. Tudo o que mostra é esse erro que não ajuda.

As melhores opções são usar FTP ou o cPanel do seu host. Vou usar o cPanel para este exemplo, mas o processo é o mesmo. Primeiro, abra o Gerenciador de Arquivos no cPanel.

Em seguida, abra a pasta do site em que está trabalhando. Se for o site principal, você verá um ícone de globo. Caso contrário, abra a pasta com o nome do site.

Navegue até a pasta wp-content.

Navegue até a pasta com o tema ou plugin que você deseja editar. Nesse caso, estou editando um tema.

Selecione a pasta do tema ou plugin. Estou selecionando a pasta para o tema Twenty Twenty One.

Em seguida, vá para o arquivo que você estava editando quando o problema ocorreu. Eu estava editando o arquivo functions.php. Baixe o arquivo para trabalhar offline ou edite o arquivo. Eu recomendo baixar um backup antes de fazer alterações.

Seu editor de código pode fornecer informações sobre o erro. No meu caso, está mostrando que está esperando um parêntese na linha 29. Na verdade, está faltando um colchete na linha 17, o que faz com que o editor pense que precisa de um parêntese.

Adicionar o colchete remove o erro. Agora posso carregar meu novo arquivo para substituir o arquivo atual ou salvá-lo se estiver usando o editor online.

Meu site agora funciona normalmente.

Restaurando um arquivo anterior

Se você não tiver certeza do que mudou no código e quiser restaurar um arquivo anterior que você sabe que funciona, vá para o arquivo no FTP ou cPanel.

Às vezes, o WordPress não informa de onde está vindo o problema. Nesse caso, você pode renomear as pastas uma por vez para ver se o problema desaparece. Comece com seus plug-ins.

Se você souber de onde o problema está vindo, você pode carregar um arquivo de substituição. Para um plugin ou tema no repositório do WordPress, você pode excluir a pasta e reinstalá-lo.

Se preferir, você pode baixar o tema ou plug-in do repositório do WordPress (ou de onde o obteve), descompactar o arquivo e substituir apenas o arquivo necessário. Funciona de forma semelhante à forma como substituiremos o WordPress na próxima seção.

Faça upload de uma cópia limpa do WordPress

Se o problema for o núcleo do WordPress, você pode carregar uma nova versão do WordPress sem excluir seus arquivos. Baixe uma nova cópia do WordPress e descompacte-o.

Em seguida, exclua a pasta wp-content e o arquivo chamado wp-config-sample.php.

Em seguida, carregue os arquivos do WordPress da pasta descompactada para a pasta raiz do WordPress. Isso substituirá todos os arquivos, exceto os dois que você excluiu. Seu site deve funcionar agora.

Encerrando reflexões sobre o erro de análise Erro de sintaxe Fim inesperado no WordPress

O erro de sintaxe de análise final inesperado no WordPress é um erro comum para qualquer pessoa que lida com código. Não é difícil de consertar, mas às vezes pode levar algum tempo para rastreá-lo. As etapas são simples:

• Se você adicionou o código, comece por aí.
• Se você instalou um plugin ou tema, desative-o.
• Quando você não conseguir encontrar o problema, substitua os arquivos suspeitos.
• Quando tudo mais falhar, restaure um backup.

Seguir algumas etapas de solução de problemas ajudará no funcionamento do seu site o mais rápido possível.

Nós queremos ouvir de você. Você teve o erro de análise de sintaxe final inesperado no WordPress? Deixe-nos saber como você corrigiu nos comentários abaixo.

Imagem em destaque via alexdndz / shutterstock.com