Como resolver o erro de sintaxe (500) após editar o arquivo functions.php do tema

🥋 Erro 500 depois de mexer no functions.php? Calma, a Sensei te ajuda a resolver

Oi! Se seu site "quebrou" logo depois de você editar o arquivo functions.php do tema e agora está aparecendo uma tela de erro (geralmente "Erro 500" ou uma mensagem de "erro de sintaxe" / "syntax error"), respira fundo: isso é um dos problemas mais comuns do WordPress e, na grande maioria das vezes, dá pra resolver em poucos minutos. Vamos juntos, passo a passo. 💛

Por que isso acontece?

O arquivo functions.php é um dos arquivos mais sensíveis do WordPress: ele é PHP puro, e qualquer detalhezinho fora do lugar — uma chave { ou } faltando, um ponto e vírgula ; esquecido, uma aspas que não foi fechada — já é suficiente pra travar o site inteiro. Isso é chamado de erro de sintaxe, e como o functions.php é carregado antes de qualquer outra coisa no tema, ele derruba o site todo até ser corrigido.

💡 Dica da Sensei: isso não significa que sua hospedagem "caiu" — é o código do arquivo que tem um probleminha. A boa notícia é que dá pra resolver sem precisar de nenhum conhecimento avançado de programação.

Passo 1 — Acesse o Gerenciador de Arquivos do cPanel

1. Entre no seu cPanel (o acesso e a senha ficam disponíveis no seu painel do cliente).
2. Procure e clique em "Gerenciador de Arquivos" (File Manager).

Passo 2 — Encontre o arquivo functions.php

1. Navegue até: public_html → wp-content → themes → [pasta do seu tema].
2. Dentro dessa pasta, localize o arquivo functions.php — é ele o "culpado" da vez.

Passo 3 — Coloque o site no ar de novo (solução rápida)

Se você não tem certeza de qual linha exata quebrou o código, o caminho mais seguro e rápido é desativar temporariamente a edição que você fez, pra tirar o site do erro:

1. Clique com o botão direito no arquivo functions.php e escolha "Renomear".
2. Mude o nome para algo como functions_com_erro.php.
3. Acesse seu site novamente — se ele voltar ao ar, confirma que o erro estava mesmo naquele arquivo.

⚠️ Atenção: ao renomear o arquivo, o tema pode perder algumas funções personalizadas até você corrigir e devolver o nome original. É uma medida temporária pra "ganhar tempo" e tirar o site do erro — não é a correção definitiva.

Passo 4 — Corrija a sintaxe

1. Abra o arquivo com erro em modo de edição (clique com o botão direito → "Editar", ainda dentro do Gerenciador de Arquivos).
2. Revise a última alteração que você fez: normalmente o erro está bem perto do trecho que você adicionou ou colou. Confira se:
   • Toda chave aberta { tem uma chave fechando };
   • Todas as linhas terminam com ponto e vírgula ; quando precisam;
   • Todas as aspas ' ou " foram abertas e fechadas corretamente;
   • Não sobrou nenhuma tag <?php duplicada.
3. Corrigido o trecho, salve o arquivo e teste o site de novo.

Passo 5 — Tem um backup? Ainda mais fácil

Se você não se sentir confortável mexendo direto no código, a forma mais tranquila é restaurar uma cópia anterior do arquivo (de antes da edição), caso você tenha guardado uma, ou usar a ferramenta de Backup do cPanel para restaurar uma versão anterior do site.

Precisa de ajuda?

Se depois desses passos o site continuar com erro, ou se você não se sentir seguro mexendo no código, não se preocupe — abra um chamado com a nossa equipe pelo painel do cliente explicando o que foi editado, que a gente te ajuda a colocar tudo nos trilhos de novo. 🙌

🌟 Dica de ouro da Sensei: antes de editar o functions.php (ou qualquer arquivo do tema) da próxima vez, sempre faça uma cópia dele antes ("Copiar" no Gerenciador de Arquivos, ou baixe uma cópia pro seu computador). Assim, se algo der errado, você simplesmente devolve a versão antiga em segundos — sem susto!