{"id":4082,"date":"2023-08-08T01:41:13","date_gmt":"2023-08-08T04:41:13","guid":{"rendered":"https:\/\/www.magenteiro.com\/blog\/?p=4082"},"modified":"2023-08-08T01:46:30","modified_gmt":"2023-08-08T04:46:30","slug":"wordpress-debug-config","status":"publish","type":"post","link":"https:\/\/www.magenteiro.com\/blog\/wp\/wordpress-debug-config\/","title":{"rendered":"Debugando no WordPress do jeito certo. Como detectar erros antes que aconte\u00e7am."},"content":{"rendered":"\n

Debugar<\/em> c\u00f3digo PHP \u00e9 parte do cotidiano de desenvolvedores. Esteja voc\u00ea criando um tema, um plugin ou dando suporte e manuten\u00e7\u00e3o \u00e0 uma loja\/site existente.<\/p>\n\n\n\n

Conseguir enxergar as mensagens de erro, alertas e avisos ao inv\u00e9s de uma tela branca \u00e9 essencial para entender o que est\u00e1 errado, e assim descobrir o que fazer em seguida.<\/p>\n\n\n\n

Neste artigo voc\u00ea encontrar\u00e1 algumas ferramentas de debug<\/em> do WordPress, e como ser mais eficiente durante o desenvolvimento de plugins e temas.<\/p>\n\n\n\n

Lembre-se de sempre ativar mensagens de erros e alertas antes<\/mark> de iniciar o desenvolvimento de temas e plugins<\/a>.<\/strong><\/p>\n\n\n\n

Isso evitar\u00e1 erros desagrad\u00e1veis, e poss\u00edveis “telas brancas” em produ\u00e7\u00e3o ou em futuras atualiza\u00e7\u00f5es.<\/p>\n\n\n\n

wp-config.php para desenvolvedores<\/h2>\n\n\n\n

O arquivo wp-config.php<\/code>, localizado na raiz do seu WP cont\u00e9m diversas configura\u00e7\u00f5es, incluindo configs de banco de dados e muitas outras.<\/p>\n\n\n\n

Localize as constantes abaixo ou adicione aquelas que n\u00e3o estiverem definidas em seu arquivo wp-config.php, conforme mostrado abaixo. Isso far\u00e1 com que todos os erros e avisos sejam exibidos.<\/p>\n\n\n\n

\/\/ Habilita o modo WP_DEBUG\ndefine( 'WP_DEBUG', true );\n\n\/\/ Habilita logs no arquivo \/wp-content\/debug.log\ndefine( 'WP_DEBUG_LOG', true );\n\n\/\/ Mostra erros e warnings do WP e PHP\ndefine( 'WP_DEBUG_DISPLAY', true );\n@ini_set( 'error_reporting', E_ALL);  \/\/ adicione ' & ~E_NOTICE' (sem aspas) depois do E_ALL para evitar avisos mais simples, como de vari\u00e1veis n\u00e3o declaradas\n@ini_set( 'display_errors', 1);\n@ini_set( 'display_startup_errors', 1 );\n\n\/\/ Usa arquivos n\u00e3o minificados de JS e CSS (\u00fatil se voc\u00ea pretende modific\u00e1-los)\ndefine( 'SCRIPT_DEBUG', true );<\/pre>\n\n\n\n
WP-DEBUG<\/h3>\n\n\n\n
Essa constante PHP \u00e9 usada pra ativar o modo debug por todo WordPress. Note que n\u00e3o \u00e9 recomendado us\u00e1-lo em ambiente de produ\u00e7\u00e3o (assim como as demais configs acima).<\/p>\n\n\n\n
Erros e avisos do PHP<\/h3>\n\n\n\n
Ao usar a constante WP_DEBUG<\/code> com valor true<\/code>, erros, avisos e advert\u00eancias do PHP ser\u00e3o exibidos na tela. Por padr\u00e3o, o PHP esconderia erros e avisos, o que dificulta nosso trabalho de entender o que est\u00e1 acontecendo.<\/p>\n\n\n\n
WP_DEBUG_LOG<\/h3>\n\n\n\n
Esse amiguinho do WP_DEBUG faz com que todos os erros sejam salvos no arquivo debug.log<\/code>. Isso pode ser \u00fatil em ambientes de produ\u00e7\u00e3o, onde n\u00e3o desejamos exibir erros para o cliente final, mas desejamos analis\u00e1-los depois.<\/p>\n\n\n\n
Al\u00e9m disso, podemos gravar erros manualmente neste arquivo ao chamar o m\u00e9todo error_log()<\/code>, nativo do PHP<\/a>.<\/p>\n\n\n\n
Quando setado como true<\/code>, ele salvar\u00e1 os erros em um arquivo debug.log<\/code> no diret\u00f3rio wp-content<\/code>. Mas tamb\u00e9m podemos especificar outro caminho, como mostrado abaixo:<\/p>\n\n\n\n
define( 'WP_DEBUG_LOG', true );\n-ou-\ndefine( 'WP_DEBUG_LOG', '\/tmp\/wp-errors.log' );<\/pre>\n\n\n\n
Note: Para o WP_DEBUG_LOG<\/code> funcionar, \u00e9 preciso que o WP_DEBUG<\/code> esteja configurado como true<\/code>.<\/p>\n\n\n\n
WP_DEBUG_DISPLAY<\/h3>\n\n\n\n
Outro amiguinho do WP_DEBUG<\/code>, faz com que mensagens de erro sejam ou n\u00e3o exibidas dentro de p\u00e1ginas HTML. Por padr\u00e3o, este valor \u00e9 true<\/code>. Configurar como false<\/code> far\u00e1 os erros serem escondidos.<\/p>\n\n\n\n
Note: Para o WP_DEBUG_DISPLAY<\/code> funcionar, \u00e9 preciso que o WP_DEBUG<\/code> esteja configurado como true<\/code>.<\/p>\n\n\n\n
SCRIPT_DEBUG<\/h3>\n\n\n\n
Alguns arquivos CSS e JS possuem vers\u00f5es minificadas e comprimidas. Essas vers\u00f5es s\u00e3o geralmente ileg\u00edveis, pois n\u00e3o possuem quebra de linhas, espa\u00e7os, coment\u00e1rios, e suas vari\u00e1veis s\u00e3o renomeadas com menos caracteres.<\/p>\n\n\n\n
Ao definir a constante SCRIPT_DEBUG<\/code>, os arquivos originais ser\u00e3o carregados. Al\u00e9m do core<\/em> do WordPress, muitos m\u00f3dulos tamb\u00e9m fazem uso desta constante para definir que arquivo ser\u00e1 carregado.<\/p>\n\n\n\n
Salvando e exibindo queries do WordPress<\/h2>\n\n\n\n
Uma outra constante que pode ser definida no seu wp-config.php<\/code> \u00e9 a SAVEQUERIES<\/code>.<\/p>\n\n\n\n
define( 'SAVEQUERIES', true );<\/code><\/p>\n\n\n\n
Ao fazer isso, todas as queries executadas ser\u00e3o salvas em um array que pode ser exibido posteriormente. Ele tamb\u00e9m guardar\u00e1 o tempo que o SQL levou para ser executado e que m\u00e9todo o chamou.<\/p>\n\n\n\n
O array \u00e9 salvo na propriedade global $wpdb->queries<\/code>.<\/p>\n\n\n\n
\"Debugando<\/figure>\n\n\n\n
Plugins de Debug<\/h2>\n\n\n\n
Existem centenas de plugins para desenvolvimento WordPress, e certamente falarei deles em cursos e outros conte\u00fados por aqui.<\/p>\n\n\n\n
Abaixo recomendarei 3 que est\u00e3o na documenta\u00e7\u00e3o oficial do WordPress<\/a>, e tamb\u00e9m onde me inspirei para criar este artigo.<\/p>\n\n\n\n