{"id":230758,"date":"2022-12-04T17:11:00","date_gmt":"2022-12-04T14:11:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=230758"},"modified":"2022-12-04T17:15:09","modified_gmt":"2022-12-04T14:15:09","slug":"lendo-e-entendendo-os-logs-de-erros-do-wordpress-parte-1","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/lendo-e-entendendo-os-logs-de-erros-do-wordpress-parte-1\/","title":{"rendered":"Lendo e entendendo os logs de erros do WordPress, parte 1"},"content":{"rendered":"\n

\u00c0 medida que continuamos analisando o que significa ser um desenvolvedor independente do WordPress<\/a><\/strong>, as ferramentas necess\u00e1rias e as v\u00e1rias estrat\u00e9gias que podem melhorar nosso conjunto de habilidades, venho falando sobre as v\u00e1rias constantes, plugins e ferramentas para nos ajudar.<\/p>\n

Se voc\u00ea est\u00e1 apenas trope\u00e7ando neste post, recomendo verificar meu guia para ferramentas nativas de depura\u00e7\u00e3o do WordPress<\/a><\/strong>, bem como o restante dos posts da s\u00e9rie at\u00e9 agora.<\/a><\/strong><\/p>\n

Afinal, acho importante que todos trabalhemos na mesma base \u2013 ou algo intimamente relacionado \u2013 ao analisar essas informa\u00e7\u00f5es.<\/p>\n

\"Lendo<\/a><\/p>\n

Em \u00faltima an\u00e1lise, usar uma ferramenta como o Xdebug<\/a><\/strong> \u00e9 indispens\u00e1vel, mas temos que trabalhar para isso (para quem est\u00e1 curioso, escrevi um breve guia<\/a><\/strong> sobre isso h\u00e1 pouco mais de um ano).<\/p>\n

Por enquanto, por\u00e9m, vamos come\u00e7ar com o b\u00e1sico. No post anterior, sa\u00ed com a seguinte declara\u00e7\u00e3o:<\/p>\n

\n

Na pr\u00f3xima postagem, come\u00e7aremos a analisar o que \u00e9 necess\u00e1rio para examinar o log de erros gerado pelo WordPress e como entender as informa\u00e7\u00f5es que vemos.<\/p>\n<\/blockquote>\n

E \u00e9 isso que eu quero ver hoje porque, se nada mais, lhe dar\u00e1 algo pr\u00e1tico com o qual trabalhar.<\/p>\n

Entendendo os logs de erros do WordPress, parte 1<\/h2>\n

Antes de ir muito longe nisso, quero abordar uma quest\u00e3o que foi levantada por um membro do site.<\/p>\n

Ou seja, me perguntaram:<\/p>\n

\n

Quando vamos olhar para os princ\u00edpios orientados a objetos?<\/p>\n<\/blockquote>\n

Embora eu tenha abordado um pouco sobre isso em uma s\u00e9rie anterior<\/a><\/strong>, \u00e9 algo que estou trabalhando para abordar mais detalhadamente mais adiante nesta s\u00e9rie.<\/p>\n

Com isso dito, por\u00e9m, vamos come\u00e7ar a examinar os logs de erros.<\/p>\n

Configurando suas constantes<\/h3>\n

Se voc\u00ea n\u00e3o configurou as constantes em seu arquivo wp-config.php<\/strong>, recomendo faz\u00ea-lo agora, pois isso lhe dar\u00e1 o maior n\u00edvel de granularidade ao examinar quaisquer problemas que possam surgir.<\/p>\n

Se voc\u00ea n\u00e3o entendeu, n\u00e3o deixe de ler este post<\/a><\/strong> (e se tiver, certifique-se de que as seguintes constantes<\/a><\/strong> estejam definidas em seu arquivo de configura\u00e7\u00e3o):<\/p>\n

<?php\ndefine( 'WP_DEBUG', true );\ndefine( 'WP_DEBUG_LOG', true );\ndefine( 'WP_DEBUG_DISPLAY', true );\n@ini_set( 'display_errors', 1 );\ndefine( 'SCRIPT_DEBUG', true );\ndefine( 'SAVEQUERIES', true );<\/code><\/pre>\n
Uma vez que estejam no lugar, voc\u00ea tem tudo o que precisa para n\u00e3o apenas ver as informa\u00e7\u00f5es na tela, mas tamb\u00e9m no log de depura\u00e7\u00e3o que o WordPress gerar\u00e1.<\/p>\n
Onde est\u00e1 o registro?<\/h3>\n
Dependendo da natureza do seu ambiente, isso pode variar; no entanto, na maioria dos casos, voc\u00ea encontrar\u00e1 debug.log<\/strong> no diret\u00f3rio wp-content<\/strong> acima dos diret\u00f3rios plugins<\/strong>, themes<\/strong> e uploads<\/strong>.<\/p>\n
\"Lendo<\/a><\/p>\n
Como voc\u00ea pode ver na visualiza\u00e7\u00e3o da captura de tela acima, meu arquivo de depura\u00e7\u00e3o tem muito conte\u00fado. Veremos isso com mais profundidade na pr\u00f3xima se\u00e7\u00e3o, bem como como entend\u00ea-lo. Enquanto isso, verifique se este arquivo existe. Se existir, sinta-se \u00e0 vontade para ir em frente e examinar o conte\u00fado do arquivo. Voc\u00ea pode ou n\u00e3o entender muito do que est\u00e1 acontecendo, mas o conte\u00fado do arquivo significa que algo em um tema ou plugin est\u00e1 acionando v\u00e1rios avisos, avisos e erros do PHP<\/a><\/strong> que o WordPress est\u00e1 capturando e despejando no arquivo de log.<\/p>\n
O que \u00e9 o arquivo de log ainda significa?<\/h3>\n
Isso n\u00e3o significa necessariamente que algo est\u00e1 quebrado, mas indica que algo n\u00e3o est\u00e1 funcionando como deveria, n\u00e3o est\u00e1 sendo capturado e tratado adequadamente no n\u00edvel program\u00e1tico ou est\u00e1 simplesmente fazendo algo que n\u00e3o deveria estar fazendo.<\/p>\n
\"Lendo<\/a><\/p>\n
N\u00e3o precisa ser assim (mas pode!).<\/p>\n
Como desenvolvedores, devemos nos esfor\u00e7ar para garantir que nosso c\u00f3digo n\u00e3o gere nada que possa ser gravado no log de erros.<\/p>\n
Uma coisa \u00e9 fazer isso no desenvolvimento, pois podemos obter informa\u00e7\u00f5es sobre o que estamos fazendo e como o WordPress est\u00e1 se saindo. \u00c9 outra coisa, por\u00e9m, para algo que lan\u00e7amos no n\u00edvel de produ\u00e7\u00e3o para gerar essas coisas.<\/p>\n
Lendo o log de erros<\/h3>\n
Obviamente, h\u00e1 mais na leitura do log de erros do que apenas abri-lo. Para muitos, a impress\u00e3o inicial \u00e9 que pode ser um monte de jarg\u00e3o. Eu entendo isso tamb\u00e9m. Mas quando voc\u00ea entende o que est\u00e1 mostrando, \u00e9 muito mais f\u00e1cil de entender.<\/p>\n
Ent\u00e3o, vamos dar uma olhada em um exemplo muito simples. Este tamb\u00e9m n\u00e3o \u00e9 um exemplo inventado. Na verdade, este \u00e9 um que veio de um plugin no qual eu estava trabalhando. O log de erros cont\u00e9m as seguintes informa\u00e7\u00f5es<\/a><\/strong> :<\/p>\n
[05-Jul-2018 19:43:53 UTC] PHP Fatal error:  Uncaught Error: Class 'EasyEmailExportAdminEmailExportSubmenu' not found in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php:37\n#8 \/U in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 37\n[05-Jul-2018 19:44:03 UTC] PHP Warning:  include_once(.\/src\/Admin\/EmailExportSubmenu.php): failed to open stream: No such file or directory in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25\n[05-Jul-2018 19:44:03 UTC] PHP Warning:  include_once(): Failed opening '.\/src\/Admin\/EmailExportSubmenu.php' for inclusion (include_path='.:\/usr\/local\/Cellar\/php\/7.2.5\/share\/php\/pear') in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25<\/code><\/pre>\n
Observe que, na ess\u00eancia acima, existem tr\u00eas linhas. O melhor curso de a\u00e7\u00e3o ao ler os logs de erros \u00e9 come\u00e7ar de baixo e ir subindo. Isso ocorre porque as coisas, ao serem executadas em execu\u00e7\u00e3o, operam em uma pilha.<\/p>\n
Uma breve digress\u00e3o sobre as pilhas<\/h4>\n
N\u00e3o vou entrar na defini\u00e7\u00e3o do termo em ci\u00eancia da computa\u00e7\u00e3o, mas o c\u00f3digo \u00e9 executado e funciona de tal forma que as fun\u00e7\u00f5es ocorrem e, literalmente, na mem\u00f3ria de um computador, empilham-se umas sobre as outras.<\/p>\n
Assim, a coisa mais recente a ser executada sempre estar\u00e1 no topo, onde a raiz de onde come\u00e7a est\u00e1 na parte inferior. Como estamos escrevendo c\u00f3digo em um aplicativo pr\u00e9-existente, isso \u00e9 o WordPress; ent\u00e3o nosso c\u00f3digo provavelmente estar\u00e1 sempre no topo.<\/p>\n
\"Lendo<\/a><\/p>\n
Entendendo os logs de erros do WordPress: n\u00e3o \u00e9 esse tipo de pilha<\/p>\n
A ideia \u00e9 que o c\u00f3digo comece a ser executado no WordPress e siga at\u00e9 o trabalho que estamos fazendo. Quando h\u00e1 um aviso, um aviso ou um erro, geralmente ser\u00e1 algo em nosso c\u00f3digo (embora o WordPress n\u00e3o seja isento, geralmente \u00e9 esse o caso).<\/p>\n
Ent\u00e3o, quando voc\u00ea l\u00ea o log de erros, voc\u00ea est\u00e1, em ess\u00eancia, lendo o que \u00e9 chamado de rastreamento de pilha.<\/a><\/strong> A Wikipedia, conforme link, tem uma defini\u00e7\u00e3o bastante aprofundada sobre o assunto, mas talvez a parte mais relevante para este post seja a seguinte:<\/p>\n
\n
Os programadores geralmente usam o rastreamento de pilha durante a [depura\u00e7\u00e3o] interativa e post-mortem (https:\/\/en.wikipedia.org\/wiki\/Debugging<\/a>). Os usu\u00e1rios finais podem ver um rastreamento de pilha exibido como parte de uma mensagem de erro<\/a>, que o usu\u00e1rio pode relatar a um programador.<\/p>\n<\/blockquote>\n
Isso combina com o que eu descrevi acima, certo? Mas chega de falar sobre o que \u00e9 um rastreamento de pilha (se tornar\u00e1 mais claro \u00e0 medida que nos aprofundarmos na depura\u00e7\u00e3o), vamos voltar a ler o arquivo de log como est\u00e1 atualmente.<\/p>\n
Voltar para Ler o Log<\/h3>\n
Incluindo arquivos<\/h4>\n
Primeiro, vamos olhar para a linha de fundo na ess\u00eancia acima. Ele cont\u00e9m o seguinte:<\/p>\n
[05-Jul-2018 19:44:03 UTC] PHP Warning: include_once(): Failed opening '.\/src\/Admin\/EmailExportSubmenu.php' for inclusion (include_path='.:\/usr\/local\/Cellar\/php\/7.2.5\/share\/php\/pear') in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25<\/code><\/pre>\n
Isso est\u00e1 me dizendo que na linha 25 do meu arquivo, easy-email-export.php,<\/strong> ele falhou ao abrir um arquivo para inclus\u00e3o. Isso significa que eu tenho uma instru\u00e7\u00e3o include_once<\/strong> no c\u00f3digo que est\u00e1 referenciando .\/src\/Admin\/EmailExportSubmenu.php<\/strong> que ele n\u00e3o pode encontrar.<\/p>\n
Portanto, o melhor curso de a\u00e7\u00e3o seria encontrar a linha 25 e determinar por que ela n\u00e3o est\u00e1 localizando o arquivo. Talvez isso esteja descartando o caminho completo para onde est\u00e1 olhando. Chegaremos a isso momentaneamente quando falarmos sobre gravar no log de erros.<\/p>\n
Entendendo os Erros<\/h4>\n
Na pr\u00f3xima linha (ou seja, a linha acima da que acabamos de ver) cont\u00e9m o seguinte:<\/p>\n
[05-Jul-2018 19:44:03 UTC] PHP Warning: include_once(.\/src\/Admin\/EmailExportSubmenu.php): failed to open stream: No such file or directory in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25<\/code><\/pre>\n
Essa linha em particular difere apenas um pouco, mas fornece informa\u00e7\u00f5es adicionais e est\u00e1 contida na cl\u00e1usula que diz “Nenhum arquivo ou diret\u00f3rio". Isso \u00e9 perspicaz porque est\u00e1 literalmente nos dizendo que o arquivo n\u00e3o existe.<\/p>\n
Pelo menos, n\u00e3o existe onde est\u00e1 olhando. Ent\u00e3o as duas possibilidades s\u00e3o:<\/p>\n
    \n
  1. n\u00e3o criamos o arquivo ao qual somos refer\u00eancias,<\/li>\n
  2. estamos referenciando a localiza\u00e7\u00e3o do arquivo no lugar errado<\/li>\n<\/ol>\n
    Assim, a primeira coisa que precisar\u00edamos verificar \u00e9 se o arquivo existe no local que estamos tentando incluir. Se isso n\u00e3o acontecer, ent\u00e3o devemos criar o arquivo.<\/p>\n
    Se o arquivo existir, sabemos que o plug-in est\u00e1 tentando carreg\u00e1-lo do caminho errado. Portanto, podemos precisar examinar nosso autoloader<\/a><\/strong>, nosso caminho de inclus\u00e3o ou como os arquivos est\u00e3o sendo recuperados. Porque, provavelmente, se o arquivo existe, ele est\u00e1 tentando ser carregado de um lugar que n\u00e3o reside.<\/p>\n
    Um erro n\u00e3o detectado<\/h3>\n
    Na linha final do c\u00f3digo, voc\u00ea ver\u00e1 algo assim:<\/p>\n
    [05-Jul-2018 19:43:53 UTC] PHP Fatal error: Uncaught Error: Class 'EasyEmailExportAdminEmailExportSubmenu' not found in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php:37\n#8 \/U in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 37<\/code><\/pre>\n
    Este \u00e9 um bom exemplo, primeiro, porque declara explicitamente que este \u00e9 um erro n\u00e3o detectado. Isso significa que qualquer que seja a funcionalidade, algo est\u00e1 gerando um erro e n\u00e3o est\u00e1 sendo capturado.<\/p>\n