{"id":229736,"date":"2022-11-09T16:25:00","date_gmt":"2022-11-09T13:25:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=229736"},"modified":"2022-11-09T16:25:08","modified_gmt":"2022-11-09T13:25:08","slug":"interface-de-registro-psr-e-por-que-o-registro-e-importante","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/interface-de-registro-psr-e-por-que-o-registro-e-importante\/","title":{"rendered":"Interface de registro PSR (e por que o registro \u00e9 importante)"},"content":{"rendered":"\n

Dois recursos do PHP que acredito serem frequentemente usados \u200b\u200bem demasia quando se trata de "depura\u00e7\u00e3o" s\u00e3o o uso de echo<\/a> e var_dump<\/a>. J\u00e1 falei sobre isso em alguns artigos diferentes sobre depura\u00e7\u00e3o (como aqui<\/a> e aqui<\/a> ).<\/p>\n

E por mais que eu seja f\u00e3 de usar um depurador, acho importante implementar um tipo de sistema de log para que voc\u00ea ou seu cliente possam voltar e revisar a atividade que est\u00e1 acontecendo dentro do sistema como eles ou seus usu\u00e1rios fizeram foi, voc\u00ea sabe, us\u00e1-lo.<\/p>\n

No entanto, existem dois aspectos para fazer isso, especialmente se voc\u00ea deseja seguir a interface de registro do PSR e eles s\u00e3o:<\/p>\n

    \n
  1. as regras para a interface de registro real,<\/li>\n
  2. um projeto que implementa adequadamente a referida interface de registro.<\/li>\n<\/ol>\n

    Ent\u00e3o, por que n\u00e3o abordar os dois neste post?<\/p>\n

    A interface de registro PSR<\/h2>\n

    A interface de registro PSR<\/a> (ou PSR-3) cobre uma s\u00e9rie de coisas sobre as quais voc\u00ea pode ler com mais detalhes na p\u00e1gina real.<\/p>\n

    Esses incluem:<\/p>\n

      \n
    1. O b\u00e1sico<\/li>\n
    2. Mensagens<\/li>\n
    3. Contexto<\/li>\n
    4. Classes auxiliares<\/li>\n
    5. Pacotes<\/li>\n
    6. Interfaces<\/li>\n
    7. N\u00edveis de registro<\/li>\n
    8. E mais.<\/li>\n<\/ol>\n

      Mas para os prop\u00f3sitos deste artigo, quero falar especificamente sobre a pr\u00f3pria interface, um projeto que a implementa e por que \u00e9 importante.<\/p>\n

      A interface de registro<\/h3>\n

      A p\u00e1gina inicial da documenta\u00e7\u00e3o afirma:<\/p>\n

      \n

      Este documento descreve uma interface comum para bibliotecas de log.<\/p>\n

      O objetivo principal \u00e9 permitir que as bibliotecas recebam um objeto PsrLogLoggerInterface e gravem logs nele de forma simples e universal.<\/p>\n<\/blockquote>\n

      Do ponto de vista do desenvolvimento, isso \u00e9 bom, certo? Quero dizer, ele fornece uma maneira \u00fanica e consistente em que podemos apostar em qualquer biblioteca de log que optamos por usar em nossos projetos. Abordarei minha biblioteca preferida mais adiante no artigo.<\/p>\n

      Para aqueles novatos em programa\u00e7\u00e3o orientada a objetos ou simplesmente curiosos sobre como uma interface consistente nos beneficia, pense da seguinte maneira: independentemente do sistema escolhido, voc\u00ea tem a garantia de ter um certo conjunto de fun\u00e7\u00f5es, estados e assim por diante. pode usar em sua aplica\u00e7\u00e3o.<\/p>\n

      Em \u00faltima an\u00e1lise, adicionar um sistema de registro que tenha um padr\u00e3o pelo qual ele deve seguir oferece uma variedade de benef\u00edcios, independentemente de qual biblioteca voc\u00ea escolher (desde que esteja em conformidade com o PSR-3).<\/p>\n

      Experimente o Mon\u00f3logo<\/h3>\n

      Monolog<\/a> \u00e9 mais ou menos o utilit\u00e1rio de registro de fato para aplicativos PHP.<\/p>\n

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

      \u00c9 f\u00e1cil adicionar o projeto via Composer<\/a>, mas tamb\u00e9m inclui v\u00e1rias maneiras diferentes de gerar dados:<\/p>\n

      \n

      O Monolog envia seus logs para arquivos, soquetes, caixas de entrada, bancos de dados e v\u00e1rios servi\u00e7os da web. Veja a lista completa de manipuladores abaixo. Manipuladores especiais permitem que voc\u00ea crie estrat\u00e9gias avan\u00e7adas de registro.<\/p>\n<\/blockquote>\n

      Pessoalmente, usei-o apenas no contexto de envio de sa\u00edda para arquivos; no entanto, ter a capacidade de envi\u00e1-lo para outros sistemas (especialmente bancos de dados, como quando se trabalha com o WordPress) \u00e9 bom. Claro, voc\u00ea n\u00e3o quer abusar dessa habilidade.<\/p>\n

      Em segundo lugar, \u00e9 importante reconhecer que, embora voc\u00ea possa instanciar o Logger em uma fun\u00e7\u00e3o ou outra classe, existem outras maneiras mais orientadas a objetos de fazer isso. O PSR-3 cobre isso (como mencionado acima).<\/p>\n

      Resumindo, voc\u00ea quer ter certeza de que sua classe aceita uma inst\u00e2ncia de uma classe que implementa o LoggerInterface. O Monolog implementa essa interface, ent\u00e3o n\u00e3o h\u00e1 problema.<\/p>\n

      Al\u00e9m disso, o que acontece quando voc\u00ea tem um grupo de classes relacionadas que precisam implementar o log?<\/p>\n