Como identificar e corrigir erros comuns de sintaxe no WordPress – 2 maneiras fáceis

Publicados: 2024-08-23

Um erro de sintaxe no WordPress normalmente ocorre quando há um erro no código PHP, geralmente de um plugin personalizado, tema ou trecho de código adicionado a ' functions.php '.

Quando ocorre um erro de sintaxe, o WordPress geralmente exibe uma mensagem de erro em seu site semelhante a esta:

 Parse error: syntax error, unexpected '}' in /path/to/file.php on line 20

Esses erros podem causar problemas como:

  • Partes do seu site não funcionam
  • Riscos de segurança
  • Tela Branca da Morte
  • Uma experiência ruim para os visitantes
  • Problemas com mecanismos de pesquisa para encontrar seu site

É importante corrigir esses erros rapidamente para manter seu site funcionando perfeitamente.

Este guia orientará você nas etapas para localizar e corrigir o erro de sintaxe no WordPress.

Tipos comuns de erros de sintaxe no WordPress

Uma ilustração para erros comuns de sntax do WordPress

Erros de sintaxe são como problemas de programação – eles atrapalham o bom funcionamento do seu site WordPress. Esses erros podem acontecer em arquivos de tema, plug-ins ou até mesmo no próprio WordPress.

Para corrigir esses erros de forma eficaz, você deve primeiro aprender sobre as causas.

Erros de sintaxe podem surgir de alguns cenários comuns como:

1. Ponto-e-vírgula ausente ou extra

No PHP, cada instrução deve terminar com ponto e vírgula. Se você esquecer de colocar o ponto e vírgula no lugar certo, isso pode causar um erro de sintaxe.

 echo "Hello World" // Missing semicolon

2. Parênteses ou colchetes incomparáveis

O código PHP requer pares correspondentes de chaves {}, parênteses () e colchetes []. Incompatibilidades levam a erros.

 if (true) { // Missing closing brace echo "True";

3. Nomes de variáveis ​​incorretos

Os nomes das variáveis ​​PHP devem começar com um cifrão $ , seguido por uma letra ou sublinhado. Nomes inválidos causam erros.

 $1variable = "value"; // Invalid variable name

4. Personagens inesperados

Incluir caracteres não permitidos no código PHP pode levar a erros de sintaxe.

 echo "Hello World@"; // Unexpected character

5. Constantes indefinidas

Usar constantes sem defini-las pode causar erros.

 echo UNDEFINED_CONSTANT; // Undefined constant

6. Citações extraviadas

As strings devem ser colocadas entre aspas correspondentes. Aspas incompatíveis ou ausentes causam problemas de sintaxe.

 echo "Hello World; // Missing closing quote

7. Chamadas de função incorretas

Chamar funções com sintaxe incorreta ou parâmetros ausentes pode desencadear erros.

 my_function(param1, param2 // Missing closing parenthesis

8. Declarações de devolução ausentes

Em alguns contextos, uma instrução return ausente pode levar a erros.

 function my_function() { echo "Hello"; // Missing return statement }

No entanto, pode haver outros motivos, como plug-ins ou temas incompatíveis . Problemas de compatibilidade entre plug-ins, temas e versões do WordPress podem desencadear erros de sintaxe.

Você também pode obter erros de sintaxe devido à corrupção de arquivos. Quando arquivos principais, arquivos de tema ou arquivos de plug-in são corrompidos, o código dentro deles pode se tornar ilegível ou inconsistente. Isso leva a erros de sintaxe.

Erros de sintaxe podem ser frustrantes, mas geralmente são simples de resolver, depurando o problema e verificando a estrutura do código.

Vamos mostrar algumas soluções populares para corrigir esses erros-

Como encontrar e corrigir erros de sintaxe no WordPress

Esta é a imagem de como corrigir o erro de sintaxe no WordPress

Um erro de sintaxe interrompe a operação do seu site, resultando potencialmente em um site corrompido ou em um painel de administração inacessível. Isso não afeta apenas a experiência do usuário, mas também pode prejudicar o SEO e o tráfego.

Acima, mostramos algumas causas comuns de erros de sintaxe. Abaixo estão as etapas para diagnosticar e corrigir erros de sintaxe no WordPress.

Hoje mostraremos 2 métodos diferentes para corrigir erros de sintaxe no WordPress:

  1. Corrigindo erros de sintaxe por meio de FTP
  2. Corrigindo erros de sintaxe por meio do painel de controle

Vamos explorar os detalhes-

Antes de mergulhar no FTP, entenda a mensagem de erro. Normalmente inclui um caminho de arquivo e um número de linha. Por exemplo:

Este é um exemplo de syntex_error no wordpress

Isso informa qual arquivo e número de linha inspecionar.

Agora você precisa de um cliente FTP para acessar os arquivos do seu site. FileZilla é uma escolha popular, mas outras opções incluem Cyberduck e WinSCP.

Método 1: corrigindo erros de sintaxe por meio de FTP

Se ainda não o fez, baixe e instale um cliente FTP como o FileZilla. Você precisará de suas credenciais de FTP, que incluem nome de host, nome de usuário, senha e porta. Insira suas credenciais de FTP:

  • Host: Seu nome de domínio ou endereço IP (por exemplo, ftp.seudominio.com).
  • Nome de usuário: Seu nome de usuário FTP.
  • Senha: Sua senha do FTP.
  • Porta: Normalmente, 21 para FTP ou 22 para SFTP.

Geralmente são fornecidos pelo seu provedor de hospedagem.

Após fornecer as informações necessárias clique em “Quickconnect”. Isso dará acesso aos arquivos do seu site.

Com base na mensagem de erro, vá para a pasta que contém o arquivo mostrado na mensagem de erro. Para o exemplo de hoje, é /wp-content/themes/your-theme/functions.php .

Esta é uma captura de tela do arquivo de funções do FTP

No lado direito do FileZilla, navegue pelos diretórios para localizar o arquivo.

Nota: No lado esquerdo, você verá seus arquivos locais. Este painel é para upload e download de arquivos. Você não precisa desta seção para a tarefa de hoje.

Depois de obter o arquivo correto, clique com o botão direito e clique em Visualizar/Editar para editá-lo ou baixá-lo. É melhor fazer uma cópia do arquivo antes de fazer qualquer alteração.

Primeiro, baixe o arquivo para o seu computador.

Agora, você precisa de um editor de código para editar o arquivo. Você pode instalar um editor como SublimeText ou Visual Studio Code. Você também pode usar outros editores PHP que realcem a sintaxe. Ajuda a localizar os erros imediatamente.

Execute seu editor de código e abra o arquivo baixado. Navegue até o número de linha especificado. Aqui, precisamos encontrar a linha 42.

Procure problemas comuns, como falta de colchetes , tags ou ponto-e-vírgula. Se você encontrar algum erro de sintaxe, corrija-o.

Se você não identificar o problema, verifique as linhas de código anteriores . Como o erro pode ter surgido anteriormente.

Após editar o arquivo, salve-o em seu editor de código. Retorne ao FileZilla e carregue o arquivo modificado para substituir o existente no servidor.

Por fim, verifique seu site WordPress para garantir que o erro de sintaxe foi resolvido e que tudo está funcionando corretamente.

Método 2: corrigindo erro de sintaxe por meio do painel de controle

Você pode verificar o arquivo infectado e corrigi-lo no painel de controle de hospedagem.

Faça login no painel de controle do seu provedor de hospedagem. Os mais comuns incluem cPanel, Plesk ou um painel de controle personalizado fornecido pelo seu host.

Localize a ferramenta gerenciador de arquivos. No cPanel, geralmente é rotulado como “Gerenciador de Arquivos”. Outros painéis de controle podem ter nomes semelhantes.

Esta é uma captura de tela para descobrir o Gerenciador de Arquivos

Clique no Gerenciador de Arquivos. Com base na mensagem de erro, navegue até o arquivo. Aqui, navegaremos para: /wp-content/themes/your-theme/functions.php.

Use o gerenciador de arquivos para navegar pelos diretórios até encontrar o arquivo mencionado na mensagem de erro.

Esta é uma captura de tela para encontrar o arquivo functions.php

Clique no arquivo (por exemplo, funções.php) para selecioná-lo. Procure uma opção para editar o arquivo. No Gerenciador de Arquivos do CPanel, isso geralmente é rotulado como “Editar” ou “Editor de Código” .

Vá para o número da linha especificado na mensagem de erro. A maioria dos editores de arquivos nos painéis de controle mostrará números de linha.

Agora, procure problemas comuns de sintaxe:

  • Faltando ponto e vírgula (;)
  • Colchetes sem correspondência ({}, (), [])
  • Citações incorretas ou caracteres perdidos

Após fazer as correções necessárias, salve as alterações. Deve haver um botão “Salvar” ou opção semelhante no editor de arquivos.

Verifique novamente a linha de código que você editou. Certifique-se de que nenhum novo problema de sintaxe foi introduzido.

Saia do editor de arquivos após salvar o arquivo. Em seguida, acesse seu site WordPress e atualize-o para ver se o erro foi resolvido.

Aviso importante: se você não conseguir acessar o painel de controle ou o gerenciador de arquivos, talvez seja necessário entrar em contato com seu provedor de hospedagem para obter suporte.

É isso..!!! Você resolveu o erro de sintaxe com sucesso.

Melhores práticas para prevenir erros de sintaxe no WordPress

Para evitar erros de sintaxe no WordPress, siga estas práticas recomendadas:

  1. Use um tema filho: personalize seu site com um tema filho para que suas alterações não sejam perdidas quando você atualizar o tema principal.
  2. Teste em teste: sempre teste seu código em um site de teste antes de aplicá-lo em seu site ativo.
  3. Use um editor de código: escolha um editor de código com destaque de sintaxe para detectar erros facilmente.
  4. Validar código: use ferramentas de validação para verificar automaticamente erros de sintaxe.
  5. Mantenha-se atualizado: atualize regularmente plug-ins e temas para evitar problemas de compatibilidade e bugs.
  6. Siga os padrões de codificação: escreva código que siga os padrões de codificação do WordPress.
  7. Faça backup regularmente: certifique-se de ter backups recentes para restaurar rapidamente seu site se surgirem problemas.
  8. Habilitar depuração: ative a depuração no WordPress para obter mensagens de erro detalhadas.
  9. Use controle de versão: rastreie alterações de código com sistemas de controle de versão como Git para facilitar a reversão, se necessário.
  10. Revisões de código: use ferramentas ou obtenha revisões de pares para detectar erros de sintaxe e melhorar a qualidade do código.

Seguir essas práticas ajuda a evitar erros de sintaxe e mantém seu site WordPress funcionando perfeitamente.

Erro de sintaxe no WordPress – principais conclusões

Para combater eficazmente erros comuns em um site WordPress , você deve atualizar regularmente seus temas, plug-ins e núcleo do WordPress para garantir compatibilidade e segurança.

Utilize plug-ins de segurança confiáveis ​​para proteção contra vulnerabilidades e crie backups regulares para restaurar seu site se ocorrer um erro.

Além disso, familiarize-se com problemas comuns, como erros 404, erros internos do servidor, erros de sintaxe e conflitos de plug-ins.

Para evitar erros de sintaxe, você deve-

  • Certifique-se de que cada instrução termine com ponto e vírgula (;).
  • Certifique-se de que todo { tenha uma correspondência} e que todo [ tenha uma correspondência].
  • Procure erros de digitação ou caracteres fora do lugar.
  • Certifique-se de que as funções sejam escritas e usadas corretamente.

Sempre considere testar as alterações em um ambiente de teste antes de aplicá-las ao seu site ativo.

Você encontrou algum erro de sintaxe no WordPress ? Compartilhe sua experiência conosco na seção de comentários abaixo.

Inscreva-se no blog weDevs

Enviamos newsletter semanalmente, sem spam com certeza