Como configurar e aceder aos registos do WordPress (Guia completo)

Principais conclusões

• Os registos de erros do WordPress são essenciais para diagnosticar problemas no site causados por plug-ins, temas ou código.
• O modo de depuração ativa o registo e o ficheiro debug.log no diretório /wp-content/ armazena as informações de erro.
• O Cloudways SafeUpdates automatiza as atualizações e testes do WordPress para reduzir erros e economizar tempo.

Para os proprietários de agências que prestam serviços de desenvolvimento e manutenção de sítios Web, deparar-se com erros nos sítios Web dos clientes pode ser um desafio. Os erros e as falhas podem desmotivar as pessoas. Mostra às pessoas que algo não está bem nos bastidores.

No entanto, é claro, é importante lembrar que nenhum software é perfeito. Podem surgir problemas ou bugs, especialmente quando o WordPress é alimentado por vários temas e plugins.

A adoção de melhores práticas e a adoção de uma abordagem proactiva são cruciais para resolver estas preocupações, conduzindo a operações mais suaves. Um método eficaz para monitorizar e resolver potenciais problemas do sítio é manter e rever um registo de erros.

Existem alguns métodos através dos quais podes configurar e aceder aos registos de erros do WordPress. Neste artigo, vou dizer-te como podes ativar e aceder aos teus registos de erros do WordPress. Também vamos explorar a opção inteligente de actualizações automáticas.

O que são logs de erros do WordPress e por que eles são importantes para a solução de problemas?

O registo de erros consiste em seguir e monitorizar os problemas do sítio Web, mantendo um registo de ficheiros de texto simples no servidor Web. Estes ficheiros são actualizados sempre que ocorre um erro, permitindo a identificação e análise de problemas.

O registo de erros inclui mensagens de erro, juntamente com as respectivas datas e horas de ocorrência. Na maior parte das vezes, apresenta as seguintes informações para cada entrada.

Ao ativar o modo de depuração do WordPress, estas mensagens são reunidas num ficheiro para análise futura.

– Fonte: WordPress.com

Os registos de erros do WordPress servem como uma valiosa ferramenta de resolução de problemas para monitorizar os problemas do sítio web, uma vez que ajudam a identificar plug-ins, temas ou códigos problemáticos.

Ao examinares os registos de erros, podes identificar erros comuns do WordPress, como o ecrã branco da morte do WordPress, o erro 408 Request Timeout ou o erro SSH Connection Refused.

Agora, vamos ver o processo de localização e acesso aos teus registos de erros do WP.

Simplifica as actualizações do site do cliente com o SafeUpdates

Automatiza as actualizações do WordPress, melhora a segurança e poupa tempo valioso com o SafeUpdates. Experimenta uma média de 42 horas poupadas na manutenção do WordPress e triplica a tua produtividade.

Saber mais

Como ativar os registos do WordPress?

O passo inicial envolve a ativação do modo de depuração do WordPress, o que pode ser conseguido através de um plugin ou da implementação de código específico.

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

Por predefinição, o WordPress não ativa o registo de erros, uma vez que a depuração está desactivada. Para iniciar o registo de erros, o passo inicial é instalar um plugin de depuração do WordPress, como o plugin WP Debugging ou qualquer outro dos melhores plugins de depuração do WordPress. Também podes utilizar o plugin WordPress Query Monitor para depurar o teu site WP.

Depois de activares o plugin com sucesso, ele ativa automaticamente o modo de depuração do WordPress, permitindo que as mensagens de erro no teu site sejam gravadas e registadas para fins de análise e resolução de problemas.

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

Se fores um utilizador avançado, podes ativar o registo de erros e o modo de depuração do WordPress, mexendo no ficheiro wp-config.php através do acesso SFTP.

Nota que este método requer cautela, uma vez que cometer erros no código pode ter consequências graves para o teu sítio Web.

Passo 1. Liga-te ao teu site através de sFTP

Para começar, ativa o sFTP no teu site.

• Navega até O(s) meu(s) site(s) → Definições → Configuração de alojamento.
• Clica no botão “Enable SFTP” (Ativar SFTP).
  Receberás os detalhes de início de sessão do SFTP, incluindo o URL, o número da porta, o nome de utilizador e a palavra-passe.
• Utiliza um software FTP como o FileZilla para te ligares ao teu site com estas credenciais.

Passo 2. Localiza e faz o download do ficheiro wp-config.php

• Localiza o wp-config.php no diretório raiz do teu site.
• Descarrega uma cópia deste ficheiro para criar uma cópia de segurança.

Passo 3. Edita o ficheiro wp-config.php

• Abre o ficheiro wp-config.php utilizando um editor de texto como o Notepad.
• Procura a linha que diz define(‘WP_DEBUG’, false); e substitui-a pelo seguinte código:

define('WP_DEBUG', true);


se (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 estas alterações, o registo de erros e o modo de depuração do WordPress serão activados.

Lembra-te de manter esta funcionalidade activada apenas durante a resolução de problemas, uma vez que deixá-la ativa pode tornar o teu site mais vulnerável a tentativas de pirataria informática.

Como desativar o modo de depuração do WordPress?

Para um melhor desempenho e segurança do WordPress, sugiro que desligues o modo de depuração. Deixá-lo ligado pode tornar o teu site mais lento e até revelar informações confidenciais.

Se activaste o modo de depuração com código, para desativar o registo de erros, basta remover o código que adicionaste e repor a seguinte linha:

define('WP_DEBUG', false);

Se adicionaste um plugin para o modo de depuração, podes desactivá-lo indo a Plugins do WordPress e desactivando o plugin WP Debugging.

Experimenta uma hospedagem sem erros com a Cloudways

Não há mais erros irritantes de hospedagem e limitação. Com a hospedagem WordPress da Cloudways, podes desfrutar de escalabilidade sem esforço, velocidades super rápidas e alto tempo de atividade, garantindo que o teu site WP permaneça rápido e responsivo.

Começa hoje

Como encontrar ou aceder aos registos de erros do WordPress?

Depois de activares o modo de depuração do WordPress, tens de carregar o teu site para ativar quaisquer códigos de erro, que serão armazenados num ficheiro chamado debug.log. Para acederes a este ficheiro através de sFTP, segue os mesmos passos mencionados anteriormente.

Para localizar o ficheiro debug.log, navega até à pasta wp-content. Se houver erros, o ficheiro estará visível. No entanto, se não houver erros, o ficheiro não aparecerá, indicando que tudo está a funcionar corretamente.

Quando encontrares o ficheiro debug.log, transfere-o para o teu computador. Em seguida, podes abri-lo utilizando um software de edição de texto como o Bloco de notas para veres o registo completo. O registo conterá informações valiosas que podem ajudar-te a ti ou ao teu programador a identificar a origem do problema.

– ficheiro de registo wp aberto no notepad

Como corrigir problemas encontrados nos registos de erros do WordPress

O ficheiro debug.log fornece informações valiosas sobre erros e avisos no teu site, mas não se destina a ser diretamente editado. Em vez disso, deves utilizá-lo como uma referência para identificar problemas com o teu site, tema, plug-ins ou código.

Para trabalhar com o ficheiro debug.log, segue estes passos:

1. Identifica um erro ou aviso no registo de depuração.
2. Toma nota do código de erro associado à entrada.
3. Procura o significado do código de erro para compreenderes o problema específico.
4. Consulta guias ou recursos separados para encontrar soluções para corrigir esse erro específico.

Ao examinar o ficheiro debug.log, cada entrada inclui normalmente a data, a hora, o módulo, a ID do processo e o endereço IP do visitante.

No entanto, a parte mais importante é a própria mensagem de erro. Por exemplo, podes encontrar erros como “Ficheiro não encontrado”, indicando um ficheiro em falta e fornecendo o respetivo caminho.

Depois de compreenderes a causa do erro, podes proceder à sua correção. As soluções comuns incluem a atualização de ligações a ficheiros que foram movidos ou eliminados.

Ocasionalmente, podes encontrar erros de aviso (por exemplo, “bot detected for vhost”), que indicam que o servidor fechou a ligação. O registo de depuração deve fornecer mais detalhes sobre o motivo pelo qual a ligação foi encerrada, tal como a deteção de um bot potencialmente prejudicial.

Lembra-te de que o ficheiro debug.log serve principalmente para fins de resolução de problemas e não deve ser modificado diretamente. Ele serve como uma ferramenta valiosa para diagnosticar e resolver problemas no seu site.

Como usar os registos de erros do WP para identificar e resolver problemas relacionados com o desempenho

Existem vários tipos de registos de erros do WordPress que podes encontrar, e tentar listá-los todos aqui resultaria numa compilação extensa e exaustiva.

Mas ainda assim, podemos ver um exemplo para ver como se pode olhar para os registos de erros para identificar e resolver problemas relacionados com o desempenho.

Por exemplo, erro de permissões…

Um erro de permissões no registo de erros desencadeia um aviso do PHP. Este tipo de erro ocorre quando um ficheiro está a ser acedido com permissões incorrectas.

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

Exemplo 1:

PHP Warning: O fluxo não pôde ser aberto para escrita no ficheiro "/path/to/yourblog/wp-content/themes/badperms/lib/css/theme.css" devido a permissão negada. Este erro teve origem no ficheiro "/path/to/yourblog/wp-content/themes/WFTDAtv/lib/less/lessc.inc.php" na linha 1418...

Exemplo 2:

[Sat May 31 21:30:22 2023] [error] [client 127.0.0.1] PHP Warning: O fluxo não pôde ser aberto para escrita no ficheiro "/path/to/yourblog/wp-content/themes/yoo_phoenix_wp/cache/xml-80a72b04a693554d055946d5ad954588.php" devido a permissão negada. Este erro ocorreu no ficheiro "/path/to/yourblog/wp-content/themes/yoo_regvis_wp/warp/helpers/xml.php" na linha 34. Página de referência: http://example.com/wp-admin/customize.php

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

Exemplo 3:

PHP Aviso: Falha ao abrir o fluxo para escrita no ficheiro "/path/to/yourblog/wp-content/cache/autoptimize/autoptimize_f7d7e4c8e9a3146b6b514d7e7f9e2468.php" devido a permissão negada. Este erro teve origem no ficheiro "/path/to/yourblog/wp-content/plugins/plugin_folder/plugin_file.php" na linha 22...

Como automatizar as atualizações com o SafeUpdates da Cloudways

Estamos em 2025. As tarefas NÃO têm de ser complicadas.

Gerir uma agência é como fazer malabarismos com um milhão de bolas. E atualizar o WordPress pode consumir horas, por vezes até dias.

Além disso, os frequentes “500 Internal Server“, “503 Service Temporarily Unavailable” ou “409 Conflict error” durante estas actualizações podem interferir com tarefas importantes em que estás a trabalhar. É stressante.

Portanto, é inteligente explorar maneiras pelas quais seu site faz automaticamente parte do trabalho pesado. Uma maneira que a Cloudways pode ajudar-te a evitar confusão e frustração é através do nosso add-on opcional, SafeUpdates.

SafeUpdates by Cloudways for WordPress é um complemento opcional que automatiza as atualizações do WordPress, simplificando o processo de deteção, teste e implantação de atualizações de núcleo, tema e plug-in.

Quer sejas um criador web ocupado ou um empresário, bastam-te alguns cliques para colocares o teu site WordPress em piloto automático. E se fores um utilizador da Cloudways, podes ter esta funcionalidade revolucionária por apenas $2/mês por aplicação.

O add-on dá-te controlo total. Podes atualizar instantaneamente ou agendar para um horário que funcione melhor para ti. Além disso, o SafeUpdates é super fácil de usar diretamente do painel do Cloudways.

— Imagem mostra o agendamento no SafeUpdates

Com o seu fluxo de trabalho automatizado, o SafeUpdates garante um agendamento de actualizações eficiente e seguro, libertando o seu tempo para tarefas comerciais mais importantes.

Funcionalidade de testes automatizados do SafeUpdates: Como funciona?

Para os programadores e agências responsáveis pela gestão dos sítios dos clientes, a funcionalidade de testes automatizados da SafeUpdates é um fator de mudança.

Quando são detectadas actualizações (núcleo, tema e plugins), o SafeUpdates desencadeia automaticamente uma série de acções para iniciar o processo de atualização. Começa por fazer uma nova cópia de segurança, o que é crucial quando se lida com sites de clientes para garantir a integridade dos dados e fornecer uma rede de segurança no caso de algo correr mal.

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

Ao avaliar minuciosamente as actualizações num ambiente controlado, podes identificar e resolver quaisquer potenciais problemas antes de estes afectarem o site ativo.

Depois de as actualizações passarem nos testes, coloca-as automaticamente em funcionamento, para que os seus clientes obtenham imediatamente as melhores e mais recentes actualizações, como melhorias de segurança e correcções de erros. Se algo correr mal durante os testes, reverte rapidamente as actualizações, para que o seu site nunca fique em baixo.

Como programador ou agência, a automatização do processo de atualização e a realização de testes exaustivos poupam-te tempo e reduzem o risco de erros ou problemas de compatibilidade. SafeUpdates mantém-te informado durante todo o processo, enviando até notificações sobre o estado das actualizações.

Este nível de transparência permite-te estar a par do processo de atualização e manter os teus clientes informados.

Uma ferramenta como esta simplifica o teu fluxo de trabalho, minimiza os riscos e mantém os sítios Web a funcionar sem problemas.

Práticas recomendadas para a resolução de problemas com os registos de erros do WordPress

Os registos do WordPress podem ajudar-te a encontrar e resolver problemas grandes e pequenos. Mas, como qualquer ferramenta, eles precisam ser usados corretamente. Aqui estão algumas dicas para tirares o máximo partido deles:

• Definir um limite de ficheiros de registo

Se o teu registo de erros for demasiado grande, pode consumir espaço em disco e tornar o teu site mais lento. Define um script ou configura o servidor para eliminar automaticamente os registos com mais de um determinado número de dias, ou talvez até reveja e elimine manualmente ficheiros de registo grandes de vez em quando.

• Corrige erros comuns

Descobre os erros comuns e repetitivos. Por exemplo, evita exceder o limite de memória aumentando a memória em wp-config.php ou desactiva os plug-ins adicionados recentemente para evitar conflitos de plug-ins. Outro exemplo de um problema comum são os erros de tema.

• Faz sempre cópias de segurança!

Faz sempre uma cópia de segurança antes de começares a mexer no teu site com base no que encontras nos registos. Dessa forma, se algo correr mal, podes simplesmente carregar no botão de reiniciar.

• Automatiza as actualizações

Configura a monitorização do registo de erros com ferramentas de automatização. Podes utilizar o SafeUpdates da Cloudways. Detecta, testa e implementa automaticamente as actualizações do WordPress enquanto te concentras no crescimento do teu negócio.

• Monitoriza os registos do servidor

Não olhes apenas para os registos do WordPress. Verifica também os registos do teu servidor de alojamento. Eles podem revelar problemas como falta de recursos ou falhas no servidor. A maioria dos painéis de controle de hospedagem facilita a localização desses logs.

• Depura durante a produção

Como mencionado acima, assim que os problemas forem resolvidos, desativa a depuração para evitar o registo desnecessário, bem como quaisquer potenciais riscos de segurança.

Resultados de desempenho de alto nível no nosso alojamento WordPress gerido

Esquece a gestão de alojamento e desfruta de resultados de desempenho extremamente rápidos com o alojamento gerido pela Cloudways. Concentra-te apenas no crescimento da tua marca.

Começa hoje

Considerações finais

Os registos de erros do WordPress são cruciais para uma resolução eficaz de problemas e para manter uma presença online fiável. Permitem-te identificar e resolver erros a tempo, salvaguardando a reputação do teu site e a experiência dos visitantes. Além disso, as cópias de segurança e uma área de preparação são como redes de segurança, dando-te uma forma de desfazer erros se algo correr mal.

Para tornar seu fluxo de trabalho ainda melhor e economizar muito tempo, a Cloudways oferece o SafeUpdates. Ele automatiza atualizações seguras para sites do WordPress, eliminando a necessidade de qualquer intervenção manual para ativar os logs do WordPress.