{"id":229613,"date":"2022-11-09T17:09:00","date_gmt":"2022-11-09T14:09:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=229613"},"modified":"2022-11-09T17:14:19","modified_gmt":"2022-11-09T14:14:19","slug":"interface-de-journalisation-psr-et-pourquoi-la-journalisation-est-importante","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/interface-de-journalisation-psr-et-pourquoi-la-journalisation-est-importante\/","title":{"rendered":"Interface de journalisation PSR (et pourquoi la journalisation est importante)"},"content":{"rendered":"\n

Deux fonctionnalit\u00e9s de PHP qui, \u00e0 mon avis, sont souvent surutilis\u00e9es en mati\u00e8re de "d\u00e9bogage" utilisent echo<\/a> et var_dump<\/a>. J’en ai parl\u00e9 dans quelques articles diff\u00e9rents sur le d\u00e9bogage (comme ici<\/a> et ici<\/a> ).<\/p>\n

Et m\u00eame si je suis fan de l’utilisation d’un d\u00e9bogueur, je pense qu’il est \u00e9galement important d’impl\u00e9menter un type de syst\u00e8me de journalisation afin que vous ou votre client puissiez revenir en arri\u00e8re et revoir l’activit\u00e9 qui s’est produite dans le syst\u00e8me au fur et \u00e0 mesure qu’eux-m\u00eames ou leurs utilisateurs l’ont fait. \u00e9t\u00e9, vous savez, l’utiliser.<\/p>\n

Cependant, il y a deux aspects \u00e0 faire, surtout si vous cherchez \u00e0 suivre l’interface de journalisation PSR et ils sont :<\/p>\n

    \n
  1. les r\u00e8gles de l’interface de journalisation proprement dite,<\/li>\n
  2. un projet qui impl\u00e9mente correctement ladite interface de journalisation.<\/li>\n<\/ol>\n

    Alors pourquoi ne pas aborder les deux dans cet article\u00a0?<\/p>\n

    L’interface de journalisation PSR<\/h2>\n

    L’ interface de journalisation PSR<\/a> (ou PSR-3) couvre un certain nombre de choses que vous pouvez lire plus en d\u00e9tail sur la page actuelle.<\/p>\n

    Ceux-ci inclus:<\/p>\n

      \n
    1. Les bases<\/li>\n
    2. messages<\/li>\n
    3. Le contexte<\/li>\n
    4. Classes d’assistance<\/li>\n
    5. Paquets<\/li>\n
    6. Interfaces<\/li>\n
    7. Niveaux de journalisation<\/li>\n
    8. Et plus.<\/li>\n<\/ol>\n

      Mais pour les besoins de cet article, je veux parler sp\u00e9cifiquement de l’interface elle-m\u00eame, d’un projet qui l’impl\u00e9mente et pourquoi c’est important.<\/p>\n

      L’interface de journalisation<\/h3>\n

      La page d’accueil de la documentation indique :<\/p>\n

      \n

      Ce document d\u00e9crit une interface commune pour la journalisation des biblioth\u00e8ques.<\/p>\n

      L’objectif principal est de permettre aux biblioth\u00e8ques de recevoir un objet PsrLoggerInterface et d’y \u00e9crire des journaux de mani\u00e8re simple et universelle.<\/p>\n<\/blockquote>\n

      Du point de vue du d\u00e9veloppement, c’est bien, non\u00a0? Je veux dire, cela fournit un moyen unique et coh\u00e9rent sur lequel nous pouvons parier pour la biblioth\u00e8que de journalisation que nous choisissons d’utiliser dans nos projets. Je couvrirai ma biblioth\u00e8que pr\u00e9f\u00e9r\u00e9e plus tard dans l’article.<\/p>\n

      Pour ceux qui d\u00e9couvrent la programmation orient\u00e9e objet ou qui sont simplement curieux de savoir comment une interface coh\u00e9rente nous profite, pensez-y de cette fa\u00e7on\u00a0: quel que soit le syst\u00e8me que vous choisissez, vous \u00eates assur\u00e9 d’avoir un certain ensemble de fonctions, d’\u00e9tats, etc. pouvez utiliser dans votre application.<\/p>\n

      En fin de compte, l’ajout d’un syst\u00e8me de journalisation qui a une norme qu’il doit suivre offre une vari\u00e9t\u00e9 d’avantages quelle que soit la biblioth\u00e8que que vous choisissez (tant qu’elle est conforme \u00e0 PSR-3).<\/p>\n

      Essayez Monologue<\/h3>\n

      Monolog<\/a> est plus ou moins l’utilitaire de journalisation de facto pour les applications PHP.<\/p>\n

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

      Il est facile d’ajouter le projet via Composer<\/a>, mais il inclut \u00e9galement diff\u00e9rentes mani\u00e8res de g\u00e9n\u00e9rer des donn\u00e9es\u00a0:<\/p>\n

      \n

      Monolog envoie vos journaux vers des fichiers, des sockets, des bo\u00eetes de r\u00e9ception, des bases de donn\u00e9es et divers services Web. Voir la liste compl\u00e8te des gestionnaires ci-dessous. Des gestionnaires sp\u00e9ciaux vous permettent de cr\u00e9er des strat\u00e9gies de journalisation avanc\u00e9es.<\/p>\n<\/blockquote>\n

      Personnellement, je ne l’ai utilis\u00e9 que dans le cadre de l’envoi de sorties vers des fichiers\u00a0; cependant, avoir la possibilit\u00e9 de le sortir sur d’autres syst\u00e8mes (en particulier des bases de donn\u00e9es comme lorsque vous travaillez avec WordPress) est agr\u00e9able. Bien s\u00fbr, vous ne voulez pas abuser de cette capacit\u00e9.<\/p>\n

      Deuxi\u00e8mement, il est important de reconna\u00eetre que bien que vous puissiez instancier le Logger dans une fonction ou une autre classe, il existe d’autres moyens plus orient\u00e9s objet de le faire. PSR-3 couvre cela (comme mentionn\u00e9 ci-dessus).<\/p>\n

      En bref, vous voulez vous assurer que votre classe accepte une instance d’une classe qui impl\u00e9mente LoggerInterface. Monolog impl\u00e9mente ladite interface, donc ce n’est pas un probl\u00e8me.<\/p>\n

      De plus, que se passe-t-il lorsque vous avez un groupe de classes li\u00e9es qui doivent toutes impl\u00e9menter la journalisation\u00a0?<\/p>\n