Debug Log Manager

Descrição

O Debug Log Manager permite que você:

  • Ative o WP_DEBUG com um clique para registrar erros de PHP, banco de dados e JavaScript quando você precisar e desative quando terminar. Não é necessário editar manualmente o arquivo wp-config.php.
  • Crie o arquivo debug.log para você em um local não padrão com um nome de arquivo personalizado para maior segurança.
  • Copie o conteúdo do arquivo debug.log padrão/existente para o arquivo debug.log personalizado e exclua o arquivo debug.log padrão/existente. Portanto, há continuidade no registro e segurança reforçada a partir de agora.
  • Analise o arquivo debug.log e visualize os diferentes erros e quando eles ocorreram pela última vez, o que é melhor do que examinar o arquivo de registro bruto (potencialmente) cheio de erros repetitivos.
  • Encontre e filtre rapidamente erros mais específicos para o seu processo de depuração.
  • Torne os detalhes dos erros mais fáceis de ler, identificando a origem do erro (arquivos básicos/plugins/temas) e separando o caminho do arquivo e o número da linha.
  • Visualize os arquivos em que ocorreram erros de PHP de forma prática. Isso inclui os arquivos básicos, de plugins, temas e do WordPress.
  • Ative a atualização automática para carregar automaticamente novas entradas de registro. Não há necessidade de recarregar manualmente a aba do navegador ou usar o tail -f no arquivo de registro na linha de comando.
  • Limpe rapidamente o arquivo debug.log para economizar espaço em disco e observar melhor os erros que ocorrem no seu site.
  • Mostre um indicador na barra administrativa quando o registro de erros estiver ativado.
  • Adicione um widget no painel que mostra os últimos erros registrados.
  • Use error_log() para enviar informações de erro para o seu registro de depuração. Ex: error_log( $error_message ) para uma mensagem de erro simples, baseada em string, ou error_log( json_encode( $error ) ) ao inspecionar uma informação de erro mais complexa, por exemplo, uma array ou um objeto.

Uma versão mais simples e compacta do Debug Log Manager está incluída como parte do plugin System Dashboard, caso você queira um único plugin que tenha mais recursos.

O que os usuários dizem

“Este é um ótimo plugin para desenvolvedores especialmente para pessoas que mexem no código.” ~PK Son

“Usei alguns outros plugins de registro e este é, de longe, o melhor.” ~Brian Henry

Outra grande ferramenta para economizar tempo. ~Jeff Starr

Retribua

Confira também

  • System Dashboard: Painel central para monitorar vários componentes, processos e dados do WordPress, inclusive o servidor.
  • Variable Inspector: inspecione as variáveis do PHP em um painel central no wp-admin para facilitar a depuração.
  • Admin and Site Enhancements ajuda você a melhorar os vários fluxos de trabalho administrativos e aspectos do site, substituindo vários plugins que fazem isso.
  • WordPress Newsboard: As últimas notícias, artigos, podcasts e vídeos de mais de 100 fontes focadas no WordPress.

Capturas de tela

  • Página principal do Debug Log Manager
  • Erros fatais com o rastreamento de pilha
  • Mais exemplos de entradas de registros
  • Indicador da barra administrativa e widget do painel

Perguntas frequentes

Isso irá funcionar com a hospedagem gerenciada do WordPress que estou usando?

Talvez. Ele foi testado com o Kinsta e o GridPane (com o Secure Debug desativado). Se você achar que não está funcionando com seu servidor de hospedagem gerenciada, publique no fórum de suporte sobre o problema/erro encontrado. Posso pedir um site de teste com o qual eu possa trabalhar.

Como este plugin foi desenvolvido?

O Debug Log Manager foi desenvolvido usando a excelente classe WPConfigTransformer de WP Debug Log – Config Tool, DataTables.js, jSticky e jQuery Toast.

Avaliações

9 abril, 2025
I wish I knew about this plugin before! Very easy to use and debug in a secure way for production environments, without touching the config.php file. Awesome, thanks!
3 abril, 2025
Really makes debugging a whole lot easier… separates the errors by count, allows easy search and easy toggle on/off of debug without having to modify wp-config by hand. Just super cool and intuitive plugin. Glad that I have it.
Leia todas as 17 avaliações

Colaboradores e desenvolvedores

“Debug Log Manager” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.

Colaboradores

Debug Log Manager” foi traduzido para 5 localidades. Agradecemos aos tradutores por suas contribuições.

Traduzir o “Debug Log Manager” para seu idioma.

Interessado no desenvolvimento?

Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.

Registro de alterações

2.3.5 (2025.04.05)

  • Fixed XSS vulnerability responsibly disclosed by Yassine Neggaoui regarding the parsing of debug.log entries without proper sanitization.

2.3.4 (2025.02.19)

  • Correção do ícone da barra administrativa que não estava sendo exibido. Agradecimentos a @tobias_conrad por pedir esta correção.

2.3.3 (2024.03.20)

  • Escape adequado de $variables sem escape para melhorar a segurança. Fazendo bom uso do excelente plugin Plugin Check (PCP).

2.3.2 (2024.03.20)

  • Corrigida a vulnerabilidade de XSS divulgada de forma responsável por Majed Refaea através do Pathstack.
  • Corrigida a vulnerabilidade de controle de acesso violado divulgada de forma responsável por Majed Refaea através do Pathstack.
  • Corrigida a vulnerabilidade de ataque CSRF divulgada de forma responsável por Dhabaleshwar Das através do Pathstack.
  • Ativação da detecção de alterações no caminho da instalação do WordPress, por exemplo, ao enviar do desenvolvimento para a produção ou migrar para um novo servidor de hospedagem, e atualização das configurações de localização do arquivo de registro de depuração. Isso deve corrigir o problema em que o visualizador de entradas de registro de depuração parava de funcionar nesses cenários. Para garantir que o Debug Log Manager funcione no novo site/destino, desative-o e reative-o. Agradecimentos a @jeswd por relatar o problema aqui e @jrmyfranck e @drhnews por relatar o problema aqui.

2.3.1 (2023.11.30)

  • Melhorada a aleatoriedade do nome do arquivo de registro de depuração para melhorar a segurança.

2.3.0 (2023.11.29)

  • Melhorada a análise de entradas de registros com mais de um conjunto de informações entre colchetes, por exemplo, [timestamp] [WARNING] informações detalhadas sobre o erro. Foi analisado como “Nenhuma mensagem de erro especificada…”. Agradecimentos a @azzuwayed por fornecer uma linha de código importante com o padrão regex preg_replace correto para corrigir isso. Acho que as pessoas que conseguem produzir padrões regex conforme necessário, têm um superpoder especial!

2.2.2 (2023.11.29)

  • [SEGURANÇA] Melhorada a segurança da chamada Ajax para limpar o arquivo de registro. Autorizada apenas para administradores do site e protegida para evitar CSRF com nonce. Agradecimentos a Dmitrii Ignatyev novamente por lembrar de verificar isso também.

2.2.1 (2023.11.29)

  • [IMPORTANTE][SEGURANÇA] Corrigido um problema de segurança em que o diretório do gerenciador de registro de depuração podia ser aberto no navegador, permitindo que os visitantes vissem e baixassem o arquivo de registro de depuração, que pode conter informações confidenciais. Após atualizar para a versão 2.2.1, acesse a página de registro de depuração pelo menos uma vez. Isso cria um arquivo index.php vazio no diretório DLM e evita o problema. Esta vulnerabilidade foi divulgada de forma responsável por Dmitrii Ignatyev da CleanTalk inc. em 2 de novembro de 2023. Peço desculpas se demorei um pouco para fazer isso, pois estava muito ocupado com o lançamento do ASE Pro.

2.2.0 (2023.06.26)

  • Ocultação do widget do painel e do ícone da barra administrativa para usuários que não são administradores
  • Impedimento do carregamento do public.js na interface se o registro estiver desativado

2.1.4 (2023.04.15)

2.1.3 (2023.02.25)

2.1.0 (2023.02.21)

  • Analise corretamente o conteúdo das entradas adicionadas através da função error_log(). Em vez de print_r(), use json_encode(), se estiver tentando gerar uma $variable do PHP que contenha uma array ou objeto no registro de depuração. Por exemplo, error_log( json_encode( $variable_name ) ). Agradecimentos a @guyinpv por relatar o problema.

2.0.0 (2022.12.03)

  • Os arquivos básicos, de plugins, temas ou do WordPres em que ocorreram erros de PHP, agora podem ser facilmente visualizados, bastando clicar no caminho do arquivo em cada entrada de erro. Isso é feito usando o editor de temas/plugins dos arquivos básicos (modificado para carregar no modo apenas de visualização) e o repositório wordpress-develop no Github para arquivos básicos.
  • A constante “SCRIPT_DEBUG” agora é definida como verdadeira no “wp-config” quando o registro de erros está ativado, o que deve ajudar na depuração de erros de JavaScript.
  • Adicionado um botão para desativar o editor de plugin/tema, abaixo da tabela de entradas de erros. Isso é para quando você tiver terminado a depuração, ou seja, tiver desativado o registro de erros e limpado o arquivo de registro de depuração, e quiser manter tudo seguro.

1.9.1 (2022.12.02)

  • Corrigido o problema de estilo do dashicon de link externo em entradas, quando o banco de dados for atualizado automaticamente.

1.9.0 (2022.12.02)

  • Deteção do tipo de erro de exceção do PHP e adição ao filtro da tabela de entradas.
  • Tornadas as entradas de erros mais fáceis de ler, identificando a origem do erro (arquivos básicos/plugins/temas) e separando o caminho do arquivo e o número da linha.

1.8.7 (2022.10.22)

  • Correção da falta da função wp_date() para o WordPress antes da versão 5.3.
  • Supressão de todas as notificações administrativas ao visualizar entradas de registro. Graças a uma boa correção de @brianhenryie.
  • Melhorados os comentários em linha para alguns códigos.

1.8.6 (2022.10.09)

  • Correção da referência incorreta ao antigo app.js. Alteração para admin.js.

1.8.5 (2022.10.08)

  • Suavização do comportamento de rolagem para fixar no topo a posição do cabeçalho da página DLM.
  • Alteração do número padrão de entradas a serem exibidas no widget do painel de 10 para 5.

1.8.4 (2022.10.08)

1.8.3 (2022.10.07)

  • Correção do CSS para o widget do painel, para garantir que as mensagens de erro sejam agrupadas corretamente, ou seja, não ultrapassem o contêiner do widget.

1.8.2 (2022.10.05)

  • Correções do CSS para o rodapé do widget do painel, bem como para o dimensionamento do cabeçalho e do rodapé da página principal.

1.8.0 (2022.10.02)

  • Adicionado widget no painel que mostra os últimos erros registrados, o status do registro de erros e um link para a página do gerenciador de registro de depuração.

1.7.0 (2022.09.28)

1.6.4 (2022.09.27)

  • Correção do problema do alerta do PHP: “Tentando acessar o deslocamento da array em um valor do tipo bool” relatado por @brianhenryie e @hogash.

1.6.3 (2022.09.27)

  • Outras correções (HTML, CSS, JS) para garantir que os detalhes do erro sejam devidamente agrupados dentro da tabela de dados e não façam com que a tabela ultrapasse a largura da página. Isso inclui cenários em que a atualização automática está ativada e a paginação está em uso.

1.6.2 (2022.09.26)

  • Correção do CSS para garantir que os detalhes do erro sejam devidamente agrupados dentro da tabela de dados e não façam com que a tabela ultrapasse a largura da página.

1.6.1 (2022.09.26)

  • Melhorada a detecção do texto âncora no wp-config.php para a classe WP_Config_Transformer. Garantir que a alternância de WP_DEBUG funcione para o wp-config.php que usa “Happy publishing” ou “Happy blogging”.

1.6.0 (2022.09.25)

  • Adicionado o ícone de status da barra administrativa. Só será mostrado se o registro de erros estiver ativado e em páginas que não sejam a página principal do gerenciador de registros de depuração, incluindo a interface.

1.5.3 (2022.09.24)

  • Melhorado o analisador de registro, para lidar com mensagens de erro que contém os caracteres # e [, por exemplo, “Argumento #1” ou “[função interna]”

1.5.2 (2022.09.22)

  • Desativada a atualização automática ao usar a paginação. Caso contrário, a tabela sempre voltará para a primeira página.

1.5.1 (2022.09.21)

  • Correção de um erro de digitação no filtro suspenso do tipo de erro para “JavaScript”, impedindo que o filtro funcionasse corretamente para este tipo de erro.

1.5.0 (2022.09.21)

  • Adicionado filtro suspenso do tipo de erro.

1.4.0 (2022.09.21)

  • Os erros de JavaScript no wp-admin e na interface agora são registrados por padrão.
  • Melhorado o texto em torno dos tipos de erro para maior simplicidade e clareza.
  • Correção de um problema em que as chamadas AJAX para o recurso de atualização automática não eram interrompidas corretamente em vários cenários em que se clicava nas opções de registro de erros e/ou atualização automática.

1.3.3 (2022.09.20)

1.3.1 (2022.09.18)

  • Correção de erros no recurso de atualização automática. A desativação da atualização automática funcionava apenas nas entradas de alternância e wp_option, mas não nas chamadas de Ajax reais. Se a atualização automática estivesse ativada, ela só funcionava ao clicar no botão de alternância, mas não no carregamento da página. Ambos os problemas foram corrigidos.

1.3.0 (2022.09.18)

  • Implementação de notificações temporárias (toast) em várias conclusões de ações, por exemplo, limpeza do arquivo de registro.
  • Alteração do formato da data para M j, Y – H:i:s, por exemplo, Dez 31, 2021 – 20:06:34.
  • Implementação do recurso de atualização automática que irá carregar automaticamente as entradas de erro mais recentes a cada 5 segundos.

1.2.0 (2022.09.16)

  • Correção na detecção do arquivo de registro de depuração existente, se houver, para que ele seja copiado corretamente no arquivo de registro de depuração do DLM.
  • Atualização automática da tabela de entradas, quando o registro estiver ativado, inclusive ao copiar entradas do arquivo debug.log existente.
  • Reformulação do código: adicionado o carregador automático das classes PHP do plugin.

1.1.0 (2022.09.13)

  • Melhorada a implementação dos padrões de codificação do PHP do WP em toda a base de código.
  • Melhorada a higienização e o escape de variáveis.
  • Definição da ordenação inicial da tabela de dados, com base na coluna #, para que a coluna “Última ocorrência” seja ordenada corretamente de acordo com o registro de data e hora.
  • Adicionado o método get_value() à classe WP_Config_Transformer para funcionar com as constantes de registro de depuração existentes no wp-config.php.
  • Ativação do argumento $options para o método add() e update() no WP_Config_Transformer para garantir que a formatação das constantes do registro de depuração esteja correta no wp-config.php.

1.0.1 (2022.08.31)

  • Reformulado o código para melhorar a organização e a capacidade de manutenção.
  • Melhorada a descrição do plugin/README.md.

1.0.0 (2022.08.29)

  • Lançamento estável inicial.