Como ativar logs de erros no WordPress

Embora o WordPress seja relativamente fácil de gerenciar, a solução de problemas de erros é um problema bastante comum para seus usuários. Lidar com eles geralmente não é difícil – basta um pouco de prática. A primeira etapa de cada solução de problemas de erros do WordPress é recuperar o log de erros.

O log de erros contém todos os erros, avisos e notificações sobre o código por trás de seu site. Às vezes, pode ajudá-lo a localizar o arquivo e a linha de código exatos que estão causando o problema. O registro de erros também pode fornecer pistas para solucionar os erros aparentemente insolúveis, como “a tela branca da morte”.

Compreender o log de erros, no entanto, pode ser bastante desafiador se você não tiver experiência em tecnologia. Para se tornar um especialista em tecnologia, você precisa começar de algum lugar – então vamos começar mostrando como ativar e obter o log de erros no WordPress.

Como configurar registros de erros do WordPress em seu arquivo WP-Config

O arquivo wp-config.php é um arquivo de configuração importante do WordPress. Editando-o levemente, você habilitará a depuração padrão do WordPress e mostrará erros. Você pode fazer isso por meio de um cliente FTP ou via cPanel.

Usando um cliente FTP

Um pré-requisito para realizar qualquer edição nos arquivos do servidor é definir as permissões do arquivo de maneira adequada. As permissões sugeridas no arquivo wp-config.php são 440 ou 400. Isso significa que você só tem permissão para ler os arquivos. Para poder adquirir um log de erros, você precisa alterar as permissões do arquivo temporariamente para 644 ou 666. Para esclarecimento, o 644 concede permissões de leitura e gravação / edição para usuários administradores, enquanto o restante dos usuários obtém apenas permissões de leitura. O valor 666 fornece os dois tipos de permissões mencionados anteriormente a todos os usuários.

Para continuar, você precisa de um cliente FTP e conhecimento de edição do arquivo wp-config.php. Comece conectando-se ao servidor usando suas credenciais de FTP. Navegue até o seu diretório raiz do WordPress. Localize o arquivo wp-config.php, clique com o botão direito nele e selecione o Opção “Permissões de arquivo”.

Insira manualmente um dos valores numéricos sugeridos (644 ou 666) e clique em “OK”.

Depois de alterar as permissões, volte para o diretório raiz, clique com o botão direito no arquivo wp-config.php e selecione “Visualizar edição”.

Abra o arquivo usando um editor de texto e insira esta linha de código:

define('WP_DEBUG', true);

acima de / * Isso é tudo, pare de editar! Feliz blogging. * /.

Se o define('WP_DEBUG', false);  linha já está presente, apenas mudar falso para verdadeiro.

Salve as alterações e carregue o arquivo editado em seu diretório raiz do WordPress. Isso substituirá o arquivo que está atualmente em seu servidor.

Via cPanel

Você também pode usar o cPanel para editar o arquivo wp-config.php. Faça login no cPanel usando suas credenciais e clique no botão “Gerenciador de arquivos”.

Navegue até o diretório raiz de sua instalação do WordPress à esquerda, localize o arquivo wp-config.php, clique com o botão direito e selecione “Alterar permissões”.

Tenha certeza de habilite as permissões de leitura e gravação para o usuário (admin) marcando a caixa de seleção apropriada. Em seguida, clique em “Alterar permissões”.

Depois, clique com o botão direito no arquivo wp-config.php mais uma vez e selecione “Editar”.

O arquivo será aberto no editor cPanel padrão, então você só precisa adicionar o define('WP_DEBUG', true); acima de /* That's all, stop editing! Happy blogging. */ linha de código dentro do arquivo wp-config.

Se o arquivo já contém a seguinte linha define('WP_DEBUG', false); simplesmente altere o falso para verdadeiro e clique em “Salvar alterações” no canto superior direito da tela.

Como gerenciar erros de exibição

Depois de exibir os erros com êxito, eles serão exibidos em suas páginas, tanto no back-end quanto no front-end. A menos que seu site esteja em desenvolvimento, expor os erros ao vivo claramente não é uma boa ideia. Em vez disso, você deve salvá-los como um único arquivo e ocultá-los de seu site. Isso permitirá que você visualize o arquivo mais tarde e solucione os erros a qualquer momento.

Para fazer isso, adicione este código ao seu arquivo wp-config.php.

define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Adicione o código abaixo da seguinte linha define('WP_DEBUG', true);  e acima do /* That's all, stop editing! Happy blogging. */ linha de código.

Você pode editar o arquivo usando um cliente FTP ou via cPanel, seguindo os mesmos passos que mostramos na seção anterior. Após a edição, seu arquivo wp-config.php deve ter a seguinte aparência.

Adicionando define (‘WP_DEBUG_LOG’, true); forçamos o WordPress a armazenar todas as mensagens de erro em um arquivo. Por padrão, esse arquivo é denominado debug.log e está localizado no diretório your-WordPress-root / wp-content /. Você também pode armazenar mensagens de erro em algum outro arquivo que tenha criado. Nesse caso, altere o verdadeiro de “define (‘WP_DEBUG_LOG’, verdadeiro);” para o caminho do arquivo. Por exemplo:

define( 'WP_DEBUG_LOG', path-to-your-site/wp-content/error.log );

Além do mais, WP_DEBUG_DISPLAY determina se as mensagens de erro são mostradas ou ocultas na tela. Adicionando define (‘WP_DEBUG_DISPLAY’, false); você diz ao WordPress para ocultar as mensagens de sua tela, mas elas ainda são impressas no arquivo designado. Se você também adicione @ini_set (‘display_errors’, 0); isto irá desabilitar a impressão de erros para o seu PHP, garantindo que os usuários não consigam vê-los no front-end.

Adquirindo o log de erros

Com os erros mostrados e gravados com êxito no arquivo de log de erros apropriado, a única coisa que resta é revisar as mensagens de erro e realizar outras etapas.

Baixando manualmente o arquivo debug.log

Para baixar o arquivo de log, conecte-se ao seu servidor, navegue até o seu pasta raiz do WordPress e clique em wp-content. Encontre o debug.log arquivo dentro, clique com o botão direito nele e pressione “Download”.

Salve o arquivo em sua área de trabalho. Em seguida, certifique-se de reverter as edições anteriores. Isso inclui remover o código que você inseriu e alterar as permissões no arquivo wp-config.php para 440 ou 400. Se desejar, pode fazer isso após solucionar os erros.

Finalmente, abra o arquivo debug.log salvo com um editor de texto e verifique as mensagens de erro escritas. Dependendo do seu nível de especialização, você pode resolver os erros sozinho ou contratar um desenvolvedor.

Recursos de depuração mais avançados

Também daremos uma olhada em algumas possibilidades de depuração mais avançadas. O código a seguir deve ser adicionado em wp-config.php, acima do /* That's all, stop editing! Happy blogging. */ linha.

Este código força o WordPress a usar versões não reduzidas de arquivos CSS e JS, que é útil para depurar alterações e / ou erros encontrados especificamente em seus arquivos CSS e JS.

Ao definir a constante CONCATENATE_SCRIPTS como falso, você força WordPress para carregar todos os scripts separadamente. Isso pode ser útil para localizar scripts defeituosos / incompatíveis.

Se você estiver enfrentando problemas de banco de dados, analisar as consultas que são executadas é uma boa maneira de iniciar a depuração. Ao inserir o código acima, você coloque o conteúdo da consulta, qual função o chamou e por quanto tempo ele foi executado no array $ wpdb-> queries. Isso permitirá que você se aprofunde na parte de back-end do código do tema e no que ele está fazendo exatamente.

Então você pode adicione o seguinte código para mostrar todas as consultas em um formato legível e analisá-los.

global $wpdb;
print("<pre>".print_r($wpdb->queries,true)."</pre>");

No entanto, lembre-se de que esse código afetará o desempenho do seu site, portanto, recomendamos usá-lo apenas para fins de depuração.

Pensamentos finais

Seguindo este guia, você pode mostrar e armazenar com segurança logs de erros em um arquivo, alterar as permissões do arquivo e executar alguns recursos de depuração destinados a usuários mais avançados do WordPress. Este tutorial também o ajudará a aprender mais sobre como o seu site funciona – portanto, mantenha-o por perto, pois você pode precisar dessas instruções no futuro.