System logowania

Dokumentacja jest stale rozwijana i aktualizowana wraz z postępem projektu. Ponieważ powstaje ona równolegle z kodem, niektóre sekcje mogą tymczasowo odnosić się do wcześniejszych wersji systemu - są one sukcesywnie dostosowywane do bieżącego stanu aplikacji. Jeśli zauważysz nieaktualne informacje, zgłoś to lub załóż Issue / Pull Request.

Dokumentacja

# System logowania

# Przegląd

System logowania zapewnia standardowy interfejs do rejestrowania zdarzeń w aplikacji.

Jego struktura jest zbliżona do standardu PSR-3.


# Interfejs Loggera

use Dbm\Infrastructure\Log\Contracts\LoggerInterface;

# Poziomy logowania

PoziomOpis
awaryjnySystem nie nadaje się do użytku
alertWymagane natychmiastowe działanie
krytycznyWarunki krytyczne
błądBłędy w czasie wykonywania
ostrzeżenieOstrzeżenia
uwagaNormalne, ale istotne
informacjeInformacje
debugowanieKomunikaty na poziomie debugowania

# Przykładowe użycie

$logger->info('Użytkownik zalogowany', [
    'user_id' => 1
]);

# Dane kontekstowe

Obsługuje symbole zastępcze:

$logger->info(
    'Użytkownik {id} zalogowany',
    ['id' => 1]
);

# Ogólna metoda logowania

$logger->log('info', 'Wiadomość');

# Najlepsze praktyki

  • Używaj odpowiednich poziomów logowania
  • Unikaj rejestrowania danych wrażliwych
  • Używaj kontekstu strukturalnego

# Integracja

System logowania wykorzystywany jest m.in. w:

  • kliencie API
  • obsłudze błędów
  • systemach monitoringu