Como depurar problemas comuns do WordPress

O WordPress é um sistema CMS muito estável e, na maioria dos casos, funciona sem problemas. Devido à sua versatilidade, no entanto, em certos casos, um problema pode aparecer. Isso pode acontecer por vários motivos, e é por isso que a solução de problemas e a depuração são muito importantes. Felizmente, o WordPress vem com uma ferramenta essencial pronta para uso que tornará a tarefa muito mais fácil.

Este artigo analisa a ferramenta de depuração do WordPress antes de examinar os problemas mais comuns que muitos administradores e proprietários de sites do WordPress podem encontrar. Em seguida, examinaremos as causas e correções para ajudá-lo a voltar a funcionar rapidamente.

O que é depuração?

Como o nome indica, a depuração é um processo no qual os bugs são identificados e removidos do código do software. A maioria, se não todos, os desenvolvedores de software se encontrarão depurando o código – uma prática de rotina ao executar o código.

No entanto, mesmo que o código passe nas verificações de garantia de qualidade, novos bugs podem surgir após a instalação do software.

Isso pode acontecer por vários motivos, incluindo a instalação de software em um ambiente que o desenvolvedor não testou. É impossível para desenvolvedores e testadores de software testar seu código em todos os ambientes possíveis – nenhum software jamais seria lançado. Vamos nos aprofundar mais sobre isso mais adiante neste artigo.

Nesses casos, os administradores e proprietários do site podem precisar fazer um pouco de depuração para ajudar os desenvolvedores a identificar o problema. Embora isso possa parecer algo muito técnico, na realidade é bem fácil. Não se preocupe; este artigo irá mostrar-lhe como.

O que é um bug?

Um bug é um comportamento inesperado no software. Esse comportamento inesperado pode se manifestar de várias maneiras, incluindo erros, exceções, avisos e assim por diante. Também pode fazer com que uma função e um recurso não funcionem conforme o esperado.

Quando isso acontece, precisamos depurar o software, neste caso, o WordPress. Felizmente, o WordPress vem com uma ferramenta de depuração pronta para uso chamada WP_DEBUG.

Depuração do WordPress – WP_DEBUG e WP_DEBUG_LOG

WP_DEBUG é uma ferramenta de depuração do WordPress que vem integrada. Uma vez ativado, ele exibe todos os erros, avisos e avisos gerados pelo código PHP – a tecnologia subjacente que alimenta o WordPress.

WP_DEBUG_LOG, por outro lado, salva esses erros, avisos e notificações em um arquivo de log – facilitando o compartilhamento com terceiros. Embora seja muito diferente de um log de atividades do WordPress, ele registra todas as ações que o software faz, ajudando os desenvolvedores a identificar quais elementos do código estão agindo.

Como usar WP_DEBUG

WP_Debug é bastante fácil e direto de usar. Ele exige que você tenha acesso SFTP ou SSH ao diretório do sistema de arquivos do WordPress, portanto, convém falar com seu provedor de hospedagem se não tiver certeza se possui ou não.

Agora, a configuração está localizada em um arquivo de texto, então precisaremos usar um editor de texto para ativá-la. A boa notícia é que isso é feito a partir do arquivo wp-config.php, localizado no diretório raiz da instalação do WordPress – tornando-o super fácil de encontrar.

A configuração que você está procurando chama-se WP_DEBUG e precisa ser definida como true, conforme mostrado abaixo:

// Habilita o modo WP_DEBUG
define('WP_DEBUG', verdadeiro);

Para habilitar o registro, você precisará habilitar a opção WP_DEBUG_LOG da seguinte forma:

// Habilite o registro de depuração no arquivo /wp-content/debug.log
define( 'WP_DEBUG_LOG', true );

Se a opção WP_DEBUG_LOG não estiver disponível, você pode simplesmente copiar e colar o comando em seu arquivo wp-config.php.

Para impedir que os erros sejam exibidos no front-end do seu site WordPress, você pode definir a opção WP_DEBUG_DISPLAY como false da seguinte maneira;

define( 'WP_DEBUG_DISPLAY', false );

Observação importante: WP_DEBUG deve ser ativado em seu ambiente de teste ou teste e não em seu site ao vivo.

Se você estiver solucionando um problema específico, tente replicar o problema enquanto a opção WP_DEBUG/WP_DEBUG_LOG estiver habilitada – dependendo de quais opções você habilitou. Fazer isso causará o erro, que por sua vez fará com que a ferramenta de depuração grave no arquivo de log.

Problemas comuns do WordPress

Como mencionamos anteriormente, o WordPress é um CMS muito estável. Muitos desenvolvedores dedicam incontáveis ​​horas a cada versão, e muitas pessoas conseguem executá-la sem problemas. O mesmo vale para temas e plugins de desenvolvedores respeitáveis. No entanto, problemas e conflitos podem surgir devido a variações ambientais. Isso é verdade para software relacionado ao WordPress, assim como para qualquer outro software. Como tal, problemas podem surgir de tempos em tempos.

Um problema do WordPress, seja diretamente relacionado ao WordPress ou a um tema ou plug-in, não significa necessariamente que haja algo errado com o software. Na maioria das vezes, é um problema de configuração. De qualquer forma, WP_Debug provavelmente pode ajudá-lo a descobrir o que está acontecendo.

Tela Branca da Morte

Sintoma

A Tela Branca da Morte, também conhecida por sua sigla WSOD, se manifesta em seu site WordPress, mostrando uma tela branca completamente em branco.

Causa

Embora muitos fatores possam contribuir para um WSOD, um culpado comum são os problemas de compatibilidade com plugins e temas. Se você instalou ou atualizou recentemente um plug-in, desabilitar manualmente o plug-in ou tema deve ser sua primeira porta de escala.

Fixar

O arquivo de log de depuração pode fornecer uma visão melhor sobre qual plug-in e qual linha de código está causando o problema. Se você determinar que o culpado é um plug-in ou tema, entre em contato com o desenvolvedor para uma correção. Se o problema estiver em outro lugar, o arquivo de log fornecerá uma visão melhor sobre o que está causando o problema.
Problemas de conexão com o banco de dados

Sintoma

Os problemas de conexão com o banco de dados do WordPress podem ocorrer por vários motivos e se manifestar de diferentes maneiras. Um dos sintomas mais comuns é ver uma mensagem 'Erro ao estabelecer uma conexão com o banco de dados' em seu site.

Causa

O WordPress depende do MySQL para armazenar e ler dados como configurações e postagens. Sem uma conexão com o banco de dados do WordPress, o site não poderá funcionar. Um erro de conexão de banco de dados pode ocorrer por vários motivos, incluindo problemas de conectividade ou credenciais.

Fixar

Certifique-se de que o servidor MySQL esteja funcionando e que o WordPress possa se conectar a ele. Lembre-se de verificar as regras do firewall e o arquivo de configuração, especialmente se você tiver feito alterações ou se for uma instalação inicial. Em seguida, certifique-se de que o usuário do banco de dados do WordPress tenha direitos suficientes para as tabelas necessárias e possa executar consultas ao banco de dados.

Memória limite/esgotada

Sintoma

Quando o limite de memória for atingido, você verá um erro fatal de que a memória permitida foi esgotada.

Causa

O erro de limite de memória é um erro do PHP que pode afetar o WordPress. PHP, a tecnologia subjacente que alimenta o WordPress, usa memória para executar aplicativos, incluindo o WordPress. O limite de memória funciona como um limite rígido de RAM para evitar que o WordPress consuma muita memória e derrube o servidor. O limite padrão é 128 MB; no entanto, seu provedor de hospedagem pode definir um limite diferente.

Fixar

Antes de procurar aumentar o limite de memória, verifique se nada está consumindo mais memória do que deveria. Se o seu WordPress simplesmente cresceu muito para o limite de memória atual, você pode querer aumentá-lo. Se você estiver em um plano de hospedagem, fale com seu provedor – na maioria dos casos, você precisará atualizar seu plano.

Erro de análise: erro de sintaxe

Sintoma

Um erro de análise: Erro de sintaxe é exibido ao executar uma ação em seu site WordPress.

Causa

Um erro de análise: o erro de sintaxe ocorre quando o WordPress tenta executar o código, mas encontra um erro de sintaxe que o impede de fazê-lo. Geralmente, isso pode acontecer por um de dois motivos: ou há código faltando ou você está usando a versão incorreta do PHP.

Fixar

Verifique se você está executando a versão mais recente do PHP. Isso não é apenas uma correção fácil, mas ajudará você a garantir que está executando a versão mais recente, que pode incluir correções de bugs. Se o erro persistir, o próprio erro informará qual componente está com problemas. Isso pode ajudá-lo a identificar se é um plugin ou tema (nesse caso, você deve entrar em contato com o desenvolvedor) ou WordPress (nesse caso, você deve recarregar os arquivos principais do WordPress.

Tempo máximo de execução excedido

Sintoma

Um erro fatal: tempo máximo de execução excedido é exibido ao executar uma ação, como atualizar um plug-in.

Causa

Um erro de tempo máximo de execução excedido pode ocorrer se o tempo de execução de uma determinada ação demorar mais do que o tempo alocado. Esse limite de tempo é definido para evitar que qualquer ação monopolize todo o tempo da CPU, o que pode derrubar seu site.

Fixar

Para solucionar esse problema, primeiro identifique qual ação o causou. Veja a última coisa que você fez em seu site e, se tiver um log de atividades do WordPress, consulte-o. Em seguida, verifique os trabalhos cron usando um plug-in como o WP Crontrol e as ações agendadas para ver se há algo travado. Habilite WP_DEBUG e tente a ação novamente. Em seguida, verifique o log de erros e, se for um plugin ou tema, entre em contato com o desenvolvedor. Outra opção é aumentar o tempo de execução.

Erro do Servidor Interno

Sintoma

Um erro interno do servidor, também conhecido como Erro 500, exibe uma mensagem de Erro interno do servidor em vez do seu site WordPress.

Causa

Os erros internos do servidor não são específicos do WordPress. É um código de erro HTTP que o servidor da Web retorna quando encontra um problema para o qual não possui código. Esse erro abrangente pode dificultar a solução de problemas, pois nenhuma outra informação é fornecida.

Fixar

Corrigir um erro 500 pode envolver alguma tentativa e solução de problemas de erro. Você pode querer começar desativando todos os seus plugins e temas do WordPress, especialmente se você instalou ou atualizou algo recentemente. Em seguida, tente recarregar os arquivos principais do WordPress usando um cliente FTP. Outras correções comuns incluem verificar seu arquivo HTACCESS e aumentar o limite de memória PHP, que abordamos acima.

Falha na atualização

Sintoma

Um erro de atualização com falha é exibido após uma atualização de plug-in. Uma atualização automática com falha também pode ser exibida se você tiver atualizações automáticas ativadas.

Causa

As atualizações são um dos aspectos mais importantes da boa governança do WordPress. Eles fornecem correções e podem adicionar novas funcionalidades. Uma atualização pode não ser executada por vários motivos, incluindo uma queda na conexão com a Internet, plug-ins que não funcionam bem entre si e permissões de arquivo do WordPress.

Fixar

É improvável que uma atualização com falha derrube seu site, portanto, vale a pena tentar novamente, caso haja um problema com sua conexão. Em seguida, verifique a API REST no menu Site Health e verifique se está em execução. Se isso não corrigir o problema, verifique o log de erros para obter mais informações.

Modo de manutenção

Sintoma

O WordPress fica preso no modo de manutenção após uma atualização que não foi concluída.

Causa

Sempre que o WordPress atualiza seus arquivos, plugins ou temas, ele entra em modo de manutenção. Isso permite que o aplicativo coloque os arquivos 'offline' e os atualize. Durante esse processo, o WordPress cria um arquivo .maintenance, que armazena no diretório raiz. Se, por um motivo ou outro, uma atualização for interrompida, o WordPress pode ficar preso nesse modo de manutenção.

Fixar

Para tirar o WordPress do modo de manutenção, faça login via FTP ou SSH e exclua o arquivo .maintenance. Você também pode precisar excluir seu cache para que o site volte ao normal. WP_DEBUG pode ajudá-lo a solucionar o problema, no entanto, é recomendável que você tente isso em um ambiente de teste ou teste para evitar que seu site seja desativado.

Meu erro não está listado acima

Os ambientes do WordPress podem ser muito diferentes uns dos outros, e erros obscuros podem acontecer de tempos em tempos. Nesses casos, habilitar o modo de depuração do WordPress é um dos melhores passos que você pode tomar.

Embora isso possa parecer intimidador, pode ajudá-lo a entender melhor como o WordPress funciona e, assim, tornar-se melhor nele. Lembre-se de que ter um ambiente de teste ou teste do WordPress pode ser de grande ajuda. Esse ambiente é de grande ajuda quando se trata de solucionar problemas sem arriscar seu site ao vivo.

Solução de problemas do WordPress

O WordPress depende de várias tecnologias trabalhando juntas para garantir que seu site seja executado. Embora tenhamos abordado bastante o MySQL e o PHP, outras tecnologias, como HTML, CSS e Javascript, são cruciais para a forma como seu site é exibido e funciona.
Contanto que você escolha desenvolvedores respeitáveis, você deve ficar bem, mas muitas vezes, outros fatores podem contribuir para os erros do WordPress. É aqui que a depuração do WordPress pode ser sua amiga. Falando em desenvolvedores de plugins e temas, ajuda garantir que eles ofereçam suporte para que você possa ficar mais tranquilo sabendo que alguém está lá para ajudá-lo caso algo quebre.

A solução de problemas é uma boa habilidade e pode ajudá-lo de inúmeras maneiras. Você não apenas será capaz de minimizar o tempo de inatividade, mas também será útil ao realizar um exercício de segurança do WordPress para um site mais seguro e seguro.