{"id":229064,"date":"2022-11-09T16:37:00","date_gmt":"2022-11-09T13:37:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=229064"},"modified":"2022-11-09T16:37:14","modified_gmt":"2022-11-09T13:37:14","slug":"interfejs-rejestrowania-psr-i-dlaczego-rejestrowanie-ma-znaczenie","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pl\/interfejs-rejestrowania-psr-i-dlaczego-rejestrowanie-ma-znaczenie\/","title":{"rendered":"Interfejs rejestrowania PSR (i dlaczego rejestrowanie ma znaczenie)"},"content":{"rendered":"\n

Dwie funkcje PHP, kt\u00f3re, jak s\u0105dz\u0119, s\u0105 cz\u0119sto nadu\u017cywane, je\u015bli chodzi o \u201edebugowanie", to u\u017cycie echo<\/a> i var_dump<\/a>. M\u00f3wi\u0142em o tym w kilku r\u00f3\u017cnych artyku\u0142ach dotycz\u0105cych debugowania (takich jak tutaj<\/a> i tutaj<\/a> ).<\/p>\n

I chocia\u017c jestem fanem u\u017cywania debuggera, my\u015bl\u0119, \u017ce wa\u017cne jest r\u00f3wnie\u017c zaimplementowanie pewnego rodzaju systemu rejestrowania, aby Ty lub Tw\u00f3j klient mogli cofn\u0105\u0107 si\u0119 i przejrze\u0107 aktywno\u015b\u0107, kt\u00f3ra ma miejsce w systemie, tak jak oni lub ich u\u017cytkownicy u\u017cywa\u0142em go.<\/p>\n

S\u0105 jednak dwa aspekty, aby to zrobi\u0107, zw\u0142aszcza je\u015bli chcesz \u015bledzi\u0107 interfejs logowania PSR, a s\u0105 to:<\/p>\n

    \n
  1. zasady rzeczywistego interfejsu logowania,<\/li>\n
  2. projekt, kt\u00f3ry poprawnie implementuje wspomniany interfejs logowania.<\/li>\n<\/ol>\n

    Dlaczego wi\u0119c nie om\u00f3wi\u0107 obu w tym po\u015bcie?<\/p>\n

    Interfejs rejestrowania PSR<\/h2>\n

    Interfejs logowania PSR<\/a> (lub PSR-3) obejmuje wiele rzeczy, o kt\u00f3rych mo\u017cesz przeczyta\u0107 bardziej szczeg\u00f3\u0142owo na w\u0142a\u015bciwej stronie.<\/p>\n

    Obejmuj\u0105 one:<\/p>\n

      \n
    1. Podstawy<\/li>\n
    2. Wiadomo\u015bci<\/li>\n
    3. Kontekst<\/li>\n
    4. Zaj\u0119cia pomocnicze<\/li>\n
    5. Pakiety<\/li>\n
    6. Interfejsy<\/li>\n
    7. Poziomy dziennika<\/li>\n
    8. I wi\u0119cej.<\/li>\n<\/ol>\n

      Ale na potrzeby tego artyku\u0142u chc\u0119 opowiedzie\u0107 konkretnie o samym interfejsie, projekcie, kt\u00f3ry go implementuje i dlaczego jest to wa\u017cne.<\/p>\n

      Interfejs logowania<\/h3>\n

      Strona g\u0142\u00f3wna dokumentacji stwierdza:<\/p>\n

      \n

      W tym dokumencie opisano wsp\u00f3lny interfejs bibliotek rejestrowania.<\/p>\n

      G\u0142\u00f3wnym celem jest umo\u017cliwienie bibliotekom otrzymywania obiektu PsrLogLoggerInterface i zapisywania do niego log\u00f3w w prosty i uniwersalny spos\u00f3b.<\/p>\n<\/blockquote>\n

      Z punktu widzenia programisty to mi\u0142e, prawda? Chodzi mi o to, \u017ce zapewnia pojedynczy, sp\u00f3jny spos\u00f3b, na kt\u00f3ry mo\u017cemy postawi\u0107 na dowoln\u0105 bibliotek\u0119 rejestrowania, kt\u00f3r\u0105 zdecydujemy si\u0119 u\u017cywa\u0107 w naszych projektach. W dalszej cz\u0119\u015bci artyku\u0142u om\u00f3wi\u0119 moj\u0105 ulubion\u0105 bibliotek\u0119.<\/p>\n

      Dla tych, kt\u00f3rzy s\u0105 nowicjuszami w programowaniu obiektowym lub po prostu s\u0105 ciekawi, jakie korzy\u015bci przynosi nam sp\u00f3jny interfejs, pomy\u015bl o tym w ten spos\u00f3b: niezale\u017cnie od tego, jaki system wybierzesz, masz gwarancj\u0119 posiadania okre\u015blonego zestawu funkcji, stan\u00f3w itd. mo\u017cesz u\u017cy\u0107 w swojej aplikacji.<\/p>\n

      Ostatecznie dodanie systemu rejestrowania, kt\u00f3ry ma standard, wed\u0142ug kt\u00f3rego musi przestrzega\u0107, zapewnia szereg korzy\u015bci niezale\u017cnie od wybranej biblioteki (o ile jest on zgodny z PSR-3).<\/p>\n

      Try Monolog<\/h3>\n

      Monolog<\/a> jest mniej wi\u0119cej narz\u0119dziem do logowania de facto dla aplikacji PHP.<\/p>\n

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

      \u0141atwo jest doda\u0107 projekt za pomoc\u0105 Composera<\/a>, ale zawiera on r\u00f3wnie\u017c wiele r\u00f3\u017cnych sposob\u00f3w na wyprowadzanie danych:<\/p>\n

      \n

      Monolog wysy\u0142a logi do plik\u00f3w, gniazd, skrzynek odbiorczych, baz danych i r\u00f3\u017cnych us\u0142ug internetowych. Zobacz pe\u0142n\u0105 list\u0119 handler\u00f3w poni\u017cej. Specjalne programy obs\u0142ugi umo\u017cliwiaj\u0105 budowanie zaawansowanych strategii rejestrowania.<\/p>\n<\/blockquote>\n

      Osobi\u015bcie u\u017cywa\u0142em go tylko w kontek\u015bcie wysy\u0142ania danych wyj\u015bciowych do plik\u00f3w; jednak posiadanie mo\u017cliwo\u015bci wyprowadzania go do innych system\u00f3w (zw\u0142aszcza baz danych, takich jak podczas pracy z WordPress) jest przyjemna. Oczywi\u015bcie nie chcesz nadu\u017cywa\u0107 tej umiej\u0119tno\u015bci.<\/p>\n

      Po drugie, wa\u017cne jest, aby zda\u0107 sobie spraw\u0119, \u017ce chocia\u017c mo\u017cesz utworzy\u0107 wyst\u0105pienie Loggera w ramach funkcji lub innej klasy, istniej\u0105 inne, bardziej zorientowane obiektowo sposoby na zrobienie tego. PSR-3 obejmuje to (jak wspomniano powy\u017cej).<\/p>\n

      Kr\u00f3tko m\u00f3wi\u0105c, chcesz si\u0119 upewni\u0107, \u017ce Twoja klasa akceptuje instancj\u0119 klasy, kt\u00f3ra implementuje LoggerInterface. Monolog implementuje wspomniany interfejs, wi\u0119c to \u017caden problem.<\/p>\n

      Co wi\u0119cej, co si\u0119 dzieje, gdy masz grup\u0119 powi\u0105zanych klas, z kt\u00f3rych wszystkie musz\u0105 zaimplementowa\u0107 rejestrowanie?<\/p>\n