Ao gerir um sítio Web WordPress, depara-se comecrã em branco,mau funcionamentotalvezProblemas de carregamento da páginaé um fenómeno relativamente comum. Neste ponto, a depuração do WordPress é muito importante. O WordPress tem uma ferramenta de depuração incorporada que permite que os registos de depuração detectem erros e nos ajudem a identificar e resolver problemas.
Este artigo descreve em pormenor como ativar e utilizar os registos de depuração do WordPress e mostra como utilizar a funcionalidade de depuração de forma mais eficaz para resolver problemas do Web site.
1. encontre e active o registo de depuração do WordPress (wp-config.php)
A depuração do WordPress é feita através do comandomodificações wp-config.php
para o ativar. Este ficheiro está localizado no diretório raiz do seu sítio Web e controla a configuração básica do WordPress. É ativado através do comandoAtivar o registo de depuraçãoSe quiser, pode registar todas as mensagens de erro num ficheiro para posterior resolução de problemas.
Passos:
- Ligue-se ao servidor utilizando um cliente FTP (como o FileZilla) ou através da ferramenta de gestão de ficheiros do anfitrião.
- No diretório raiz (normalmente
public_html
talvezwww
) para encontrar a pastawp-config.php
Documentação. - Descarregue o ficheiro e abra-o com um editor de texto como o Notepad++.
- No ficheiro, encontre algo como
define( 'WP_DEBUG', false );
As linhas que irãofalso
mudar paraverdadeiro
. Se a linha não existir, pode adicioná-la manualmente:define( 'WP_DEBUG', true );
- Guarde e carregue o ficheiro, substituindo o original
wp-config.php
Documentação.
Esta ação ativa as funcionalidades básicas de depuração do WordPress. Se a página tiver erros, a mensagem de erro será apresentada na página inicial. Isto é útil para os programadores, mas se o sítio estiver ativo e aberto ao público, recomenda-se que os erros sejam registados nos registos em vez de serem apresentados diretamente.
2) Constantes PHP opcionais para efeitos de depuração
Com o modo de depuração ativado, também é possível modificar o wp-config.php
Adicione mais opções de controlo. Aqui estão duas constantes PHP muito importantes que tornam o registo de depuração melhor para o desenvolvimento e a resolução de problemas.
WP_DEBUG_DISPLAY
Esta constante controla se as informações de depuração são apresentadas no front-end. Se o site estiver a ser executado publicamente, recomenda-se que a desactive para evitar a exposição de detalhes do site a visitantes ou potenciais atacantes.
defina( 'WP_DEBUG_DISPLAY', false );
WP_DEBUG_LOG
Esta constante permite-nos registar informações de depuração num ficheiro de registo em vez de as apresentar diretamente na página Web. Quando activada, todas as informações de depuração serão registadas no ficheiro wp-content/debug.log
Documentação.
defina( 'WP_DEBUG_LOG', true );
Um exemplo completo de configuração é apresentado abaixo:
defina( 'WP_DEBUG', true );
defina( 'WP_DEBUG_DISPLAY', false );
defina( 'WP_DEBUG_LOG', true );
Com esta definição, pode garantir que as informações de depuração são apenasArmazenado no registoe não será apresentado no front end para evitar a exposição de informações sensíveis.
3. como ver os registos de depuração do WordPress
Quando o registo de depuração está ativado, todas as mensagens de erro serão registadas no ficheiro wp-content/debug.log
ficheiro. Este ficheiro de registo regista todos os erros, avisos e notificações de PHP que ocorrem. A visualização do registo ajuda a compreender a causa principal do problema, especialmente se for um plug-in ou um tema a causar o problema.
Passos:
- Utilize um cliente FTP ou uma ferramenta de gestão de ficheiros do anfitrião para aceder ao
wp-conteúdo
Pasta.
- localizar
debug.log
clique com o botão direito do rato para descarregá-lo localmente. - Abra o ficheiro utilizando um editor de texto para ver os erros, avisos e notificações registados.
Cada linha no registo de depuração conterá um carimbo de data/hora, um nível de erro e uma mensagem de erro para o ajudar a identificar o problema. Exemplo:
[28-Jul-2024 20:28:17 UTC] PHP Depreciado: Usar ${var} em strings está depreciado, use {$var} em vez disso em /home/website/public_html/wp- content/plugins/admin-notices-manager/includes/functions/core.php on line 136
Esta entrada de registo diz-nos que o código do plugin utiliza uma sintaxe PHP desactualizada e precisa de ser atualizado. Pode seguir as sugestões no registo para encontrar os ficheiros e linhas de código problemáticos e corrigi-los.
4. instale plugins para automatizar os relatórios de depuração do WordPress
Se não quiser verificar o registo de depuração manualmente todas as vezes, ou se pretender um processo de depuração mais simplificado, pode utilizar alguns plug-ins para automatizar o registo e a apresentação da depuração.Monitor de registo de erros é um plugin muito simples e eficaz que o ajuda aVeja o registo de erros diretamente no painel de controlo do WordPress.
Passos:
- Inicie sessão no seu painel de controlo do WordPress e navegue até à secção plug-in (componente de software) -> Adicionar novo plug-in.
- Escreva "Error Log Monitor" no campo de pesquisa e clique no botão montagem.
- Após a conclusão da instalação, clique em ativar.
- No painel de controlo "artefacto"Por baixo do menu, verá um novo separador."registo de erros", pode ver diretamente o registo de erros.
- Clique "configurar" para personalizar definições como a frequência de notificação para gerir melhor os registos de depuração.
Este plugin facilita a automatização de relatórios de depuração sem ter de descarregar sempre ficheiros de registo via FTP.
resumos
Ativar o modo de depuração do WordPress e utilizar os registos de depuração é um passo importante na resolução de problemas do sítio Web. A depuração é realizada através da criação de um registo de depuração na pasta wp-config.php
ativar WP_DEBUG
responder com cânticos WP_DEBUG_LOG
Pode registar todos os erros num ficheiro de registo para facilitar a sua visualização e tratamento posterior. Utilizando um ficheiro de registo como o Monitor de registo de erros Os plug-ins podem simplificar ainda mais a gestão de registos, facilitando o acompanhamento do estado operacional do seu site e a rápida resolução de problemas.