Logs do WordPress: habilitando, encontrando e corrigindo erros

Para proprietários de agências que prestam serviços de desenvolvimento e manutenção de sites, encontrar erros nos sites dos clientes pode ser um desafio. Os erros não apenas criam uma impressão negativa para visitantes e clientes em potencial, mas também indicam que algo está errado.

É importante lembrar que nenhum software é perfeito e podem surgir problemas ou bugs, principalmente quando o WordPress é aprimorado com diversos temas e plugins.

A adoção das melhores práticas e uma abordagem proativa são cruciais para responder a estas preocupações e garantir operações mais tranquilas. Um método eficaz para monitorar e solucionar possíveis problemas do site é manter e revisar um log de erros.

Ao configurar os logs de erros do WordPress no arquivo wp-config, os proprietários de agências podem simplificar o processo de monitoramento e diagnóstico de erros, melhorando assim o desenvolvimento de seus serviços de desenvolvimento e manutenção de sites.

Neste artigo, orientarei você no processo de localização e acesso aos logs de erros do WordPress.

O que são logs do WordPress e por que são essenciais para solução de problemas?

O registro de erros envolve o rastreamento e monitoramento de problemas do site, mantendo um registro de arquivos de texto simples no servidor web. Esses arquivos são atualizados sempre que ocorre algum erro, permitindo a identificação e análise de problemas.

O log de erros contém mensagens de erro, juntamente com suas respectivas datas e horas de ocorrência. Ao ativar o modo de depuração do WordPress, essas mensagens são reunidas em um arquivo para revisão futura.

Os logs de erros do WordPress servem como uma valiosa ferramenta de solução de problemas, auxiliando na identificação de plug-ins, temas ou códigos problemáticos. Ao examinar os logs de erros, você pode identificar erros comuns do WordPress , como a Tela Branca da Morte do WordPress , 408 Request Timeout Error ou SSH Connection Refused Error .

Agora, vamos nos aprofundar no processo de localização e acesso aos logs de erros do WordPress.

Habilitando registros de erros do WordPress

A etapa inicial envolve a ativação do modo de depuração do WordPress, que pode ser realizado por meio de um plugin ou pela implementação de um código específico.

Método 1: ativar o modo de depuração do WordPress com um plug-in

Por padrão, o WordPress não permite o registro de erros porque a depuração está desativada. Para iniciar o registro de erros, a etapa inicial é instalar um plugin de depuração do WordPress, como o plugin WP Debugging ou qualquer outro melhor plugin de depuração do WordPress .

Depois de ativar o plug-in com sucesso, ele ativa automaticamente o modo de depuração do WordPress, permitindo que mensagens de erro em seu site sejam registradas e registradas para fins de análise e solução de problemas.

Método 2: ativar o modo de depuração do WordPress usando código

Se você for um usuário avançado, poderá ativar o registro de erros e o modo de depuração do WordPress modificando o arquivo wp-config.php por meio do acesso SFTP.

No entanto, observe que este método requer cautela, pois cometer erros no código pode ter consequências graves para o seu site.

1. Conecte-se ao seu site via SFTP

Para começar, habilite o sFTP em seu site navegando até Meu(s) Site(s) → Configurações → Configuração de hospedagem. Clique no botão “Ativar SFTP”. Você receberá então seus detalhes de login sFTP, incluindo URL, número da porta, nome de usuário e senha. Use um software FTP como o FileZilla para se conectar ao seu site usando essas credenciais.

2. Localize e baixe o arquivo wp-config.php

Encontre o arquivo wp-config.php no diretório raiz da estrutura de arquivos do seu site, ao lado de pastas como wp-content. Baixe uma cópia deste arquivo para criar um backup.

3. Edite o arquivo wp-config.php

Abra o arquivo wp-config.php usando um editor de texto como o Bloco de Notas. Procure a linha que diz define(‘WP_DEBUG’, false); e substitua-o pelo seguinte código:

define('WP_DEBUG', true);
if (WP_DEBUG) {
        @error_reporting(E_ALL);
        @ini_set('log_errors', true);
        @ini_set('log_errors_max_len', '0');
        define('WP_DEBUG_LOG', true);
        define('WP_DEBUG_DISPLAY', false);
        define('CONCATENATE_SCRIPTS', false);
        define('SAVEQUERIES', true);
}

Com essas alterações, o registro de erros e o modo de depuração do WordPress serão habilitados. Lembre-se de manter esse recurso ativado apenas durante a solução de problemas, pois deixá-lo ativo pode tornar seu site mais vulnerável a tentativas de invasão. Para desabilitar o log de erros, simplesmente remova o código adicionado e restaure a seguinte linha:

define('WP_DEBUG', false);

Acessando registros de erros do WordPress

Depois de ativar o modo de depuração do WordPress, você deve carregar seu site para acionar quaisquer códigos de erro, que serão armazenados em um arquivo chamado debug.log. Para acessar este arquivo via sFTP, siga os mesmos passos mencionados anteriormente.

Para localizar o arquivo debug.log, navegue até a pasta wp-content. Se houver erros, o arquivo ficará visível. Porém, se não houver erros, o arquivo não aparecerá, indicando que tudo está funcionando perfeitamente.

Depois de encontrar o arquivo debug.log, baixe-o para o seu computador. Você pode então abri-lo usando um software de edição de texto como o Bloco de Notas para visualizar o log completo. O log conterá informações valiosas que podem ajudar você ou seu desenvolvedor a identificar a origem do problema.

Analisando e corrigindo problemas encontrados nos logs de erros do WordPress

O arquivo debug.log fornece informações valiosas sobre erros e avisos em seu site, mas não deve ser editado diretamente. Em vez disso, você deve usá-lo como referência para identificar problemas com seu site, tema, plug-ins ou código.

Para trabalhar com o arquivo debug.log, siga estas etapas:

• Identifique um erro ou aviso no log de depuração.
• Anote o código de erro associado à entrada.
• Procure o significado do código de erro para entender o problema específico.
• Consulte guias ou recursos separados para encontrar soluções para corrigir esse erro específico.

Ao examinar o arquivo debug.log, cada entrada normalmente inclui a data, hora, módulo, ID do processo e endereço IP do visitante. No entanto, a parte mais importante é a própria mensagem de erro. Por exemplo, você pode encontrar erros como “Arquivo não encontrado”, indicando um arquivo ausente e fornecendo seu caminho.

Depois de entender a causa do erro, você poderá corrigi-lo. As soluções comuns incluem a atualização de links para arquivos que foram movidos ou excluídos.

Ocasionalmente, você pode encontrar erros de aviso (por exemplo, “bot detectado para vhost”), que indicam que o servidor fechou a conexão. O log de depuração deve fornecer mais detalhes sobre o motivo pelo qual a conexão foi encerrada, como a detecção de um bot potencialmente prejudicial.

Lembre-se de que o arquivo debug.log serve principalmente para fins de solução de problemas e não deve ser modificado diretamente. Ele serve como uma ferramenta valiosa para diagnosticar e resolver problemas em seu site.

Usando logs de erros para identificar e resolver problemas relacionados ao desempenho

Existem vários tipos de logs de erros do WordPress que podem ser encontrados, e tentar listar todos eles aqui resultaria em uma compilação extensa e exaustiva.

Mesmo assim, podemos ver um exemplo para ver como analisar os logs de erros para identificar e resolver problemas relacionados ao desempenho.

Por exemplo, erro de permissão…

Um erro de permissão no log de erros aciona um aviso do PHP. Este tipo de erro ocorre quando um arquivo está sendo acessado com permissões incorretas.

Um cenário comum é quando os arquivos são carregados via SFTP sem redefinir as permissões por meio do painel wp-admin, resultando em configurações de permissão incorretas. É importante verificar a existência do arquivo mencionado no erro.

Exemplo 1:

PHP Warning: The stream could not be opened for writing to the file "/path/to/yourblog/wp-content/themes/badperms/lib/css/theme.css" due to permission denied. This error originated in the file "/path/to/yourblog/wp-content/themes/WFTDAtv/lib/less/lessc.inc.php" on line 1418...

Exemplo 2:

[Sat May 31 21:30:22 2023] [error] [client 127.0.0.1] PHP Warning: The stream could not be opened for writing to the file "/path/to/yourblog/wp-content/themes/yoo_phoenix_wp/cache/xml-80a72b04a693554d055946d5ad954588.php" due to permission denied. This error occurred in the file "/path/to/yourblog/wp-content/themes/yoo_regvis_wp/warp/helpers/xml.php" on line 34. Referring page: http://example.com/wp-admin/customize.php

Em certos casos, tal erro pode indicar que um plugin ou tema está tentando executar uma ação que não é permitida ou tentando acessar um arquivo ou diretório ao qual não deveria ter acesso.

Exemplo 3:

PHP Warning: Failed to open the stream for writing to the file "/path/to/yourblog/wp-content/cache/autoptimize/autoptimize_f7d7e4c8e9a3146b6b514d7e7f9e2468.php" due to permission denied. This error originated in the file "/path/to/yourblog/wp-content/plugins/plugin_folder/plugin_file.php" on line 22...

Aproveitando SafeUpdates para fluxo de trabalho de desenvolvimento aprimorado

Como proprietário de uma agência, você provavelmente é responsável por muitas tarefas de seus clientes, desde desenvolvimento e aprimoramento até atualizações regulares.

Apenas para atualizar um site WordPress, em média, as agências podem gastar de algumas horas a alguns dias atualizando os sites dos clientes.

Mas e se você puder automatizar algumas tarefas para economizar tempo e recursos?

Se você está cansado de encontrar erros confusos como “500 Internal Server” ou “503 Service Temporariamente Indisponível” ao atualizar plug-ins ou temas em seu site WordPress, Cloudways está aqui para ajudar!

SafeUpdates da Cloudways para WordPress é um complemento opcional projetado para simplificar o processo de detecção, teste e implantação de atualizações principais, de tema e de plug-in em seu site WordPress. Quer você seja um criador da web ocupado ou proprietário de uma empresa, o SafeUpdates automatiza essas tarefas com apenas alguns cliques.

SafeUpdates oferece opções de atualização flexíveis, permitindo que você execute atualizações instantaneamente ou agende-as para mais tarde, tudo dentro da plataforma de gerenciamento Cloudways amigável. Com seu fluxo de trabalho automatizado, o SafeUpdates garante um agendamento de atualizações eficiente e confiável, liberando seu tempo para tarefas comerciais mais importantes.

Utilizando o recurso de teste automatizado do SafeUpdates

Para desenvolvedores e agências responsáveis ​​pelo gerenciamento de sites de clientes, o recurso de teste automatizado do SafeUpdates é uma virada de jogo. Elimina o incômodo de atualizar sites WordPress.

Quando atualizações (núcleo, tema e plug-ins) são detectadas, o SafeUpdates aciona automaticamente uma série de ações para iniciar o processo de atualização. Ele começa com um novo backup, que é crucial ao lidar com sites de clientes para garantir a integridade dos dados e fornecer uma rede de segurança caso algo dê errado.

Antes de implantar as atualizações, o SafeUpdates cria um ambiente de teste temporário onde realiza testes abrangentes. Esses testes cobrem aspectos críticos como regressão visual, desempenho, logs e verificações de HTML.

Ao avaliar minuciosamente as atualizações em um ambiente controlado, você pode identificar e resolver quaisquer problemas potenciais antes que eles afetem o site ativo.

Depois que as atualizações passam na fase de teste, o SafeUpdates cuida da implantação de maneira inteligente. Ele implanta automaticamente as atualizações no site ativo, garantindo que seus clientes se beneficiem dos recursos mais recentes, melhorias de segurança e correções de bugs. Se surgir algum problema durante a fase de teste, o SafeUpdates reverte imediatamente as atualizações, evitando interrupções e mantendo a estabilidade do site.

Como desenvolvedor ou agência, automatizar o processo de atualização e realizar testes completos economiza seu tempo e reduz o risco de erros ou problemas de compatibilidade. SafeUpdates mantém você informado durante todo o processo, fornecendo atualizações e notificações sobre o status das atualizações. Esse nível de transparência permite que você fique por dentro do processo de atualização e mantenha seus clientes informados.

É uma ferramenta valiosa que agiliza seu fluxo de trabalho, minimiza riscos e mantém os sites de seus clientes funcionando perfeitamente.

Conclusão

Habilitar o registro de erros em seu site é crucial para uma solução de problemas eficaz e para manter uma presença online confiável. Ele permite identificar e resolver erros rapidamente, protegendo a reputação do seu site e a experiência do visitante. Além disso, os backups e os ambientes de teste fornecem uma camada extra de proteção.

Para aprimorar ainda mais seu fluxo de trabalho e economizar tempo, Cloudways oferece SafeUpdates. Esta solução poderosa automatiza atualizações seguras para sites WordPress, eliminando a necessidade de intervenção manual.

Com SafeUpdates, você pode garantir que seus plug-ins, temas e software principal estejam sempre atualizados, melhorando a segurança e o desempenho. Simplifique seu processo de atualização e maximize a eficiência com SafeUpdates da Cloudways e leve o gerenciamento do seu site para o próximo nível.

Perguntas Frequentes

Q1.Onde posso encontrar os logs do WordPress?

Para acessar seus logs de erros, vá para a pasta /wp-content/ em seu gerenciador de arquivos e localize o arquivo debug.log. Este arquivo armazena todos os erros, avisos e avisos registrados do WordPress para fácil revisão e solução de problemas.

Q2.O que são logs do WordPress?

O log de erros do WordPress serve como uma valiosa ferramenta de solução de problemas para identificar a origem dos problemas causados ​​por plug-ins, temas ou código. Ajuda a identificar e resolver problemas de forma eficiente.

Q3.O que é o log de depuração do WordPress?

O WordPress oferece uma ferramenta de depuração integrada que auxilia na identificação da causa raiz dos erros em seu site. Embora forneça informações valiosas, não é recomendado ativá-lo em um site público ativo devido a possíveis riscos de segurança.