README

PSR-3 adapter for the compono-kit/error-handlers interface.

Installation

composer require compono-kit/error-handler-adapters

Grundprinzip

Das Paket stellt einen Psr3ErrorHandler bereit, der jeden PSR-3-kompatiblen Logger (Monolog, etc.) hinter das HandlesErrors-Interface adaptiert.

LoggerInterface  →  Psr3ErrorHandler  →  HandlesErrors

Beispiele

use ComponoKit\ErrorHandlers\Adapters\Psr3ErrorHandler;
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$monolog = new Logger('app');
$monolog->pushHandler(new StreamHandler('php://stderr'));

$handler = new Psr3ErrorHandler($monolog);

$handler->warning('Speicher fast voll', ['used_mb' => 950]);
$handler->error('Datenbankverbindung fehlgeschlagen', ['host' => 'db-01']);
$handler->critical('Zahlungsdienstleister nicht erreichbar');
$handler->alert('Sicherheitscheck gescheitert', [], ['security', 'auth']);
$handler->emergency('Server antwortet nicht');

Exceptions loggen

try {
    $orderService->place($order);
} catch (\Throwable $throwable) {
    // Nachricht aus dem Throwable wird automatisch übernommen
    $handler->exception($throwable);

    // Eigene Nachricht überschreibt die des Throwable
    $handler->exception($throwable, 'Bestellung konnte nicht gespeichert werden');

    // Mit Kontext und Tags
    $handler->exception(
        $throwable,
        'Bestellung fehlgeschlagen',
        ['order_id' => $order->getId(), 'user_id' => $user->getId()],
        ['checkout', 'critical-path'],
    );

    // Expliziter Log-Level (Standard: EMERGENCY)
    $handler->exception($throwable, '', [], [], ErrorLevel::ERROR);
}

Mit dem ErrorHandlerDelegator kombinieren

Der ErrorHandlerDelegator aus compono-kit/error-handlers leitet Meldungen je nach Schweregrad an registrierte Handler weiter. Ein Handler, der auf WARNING registriert ist, empfängt alle Meldungen. Ein Handler auf CRITICAL empfängt nur critical, alert und emergency.

use ComponoKit\ErrorHandlers\ErrorHandlerDelegator;
use ComponoKit\ErrorHandlers\Adapters\Psr3ErrorHandler;
use ComponoKit\ErrorHandlers\Models\Types\ErrorLevel;

// Handler für alle Levels (WARNING aufwärts) → lokale Log-Datei
$fileLogger = new Psr3ErrorHandler($monologFileLogger);

// Handler nur für kritische Fehler (CRITICAL aufwärts) → Slack/PagerDuty
$alertLogger = new Psr3ErrorHandler($monologSlackLogger);

$delegator = new ErrorHandlerDelegator();
$delegator->addErrorHandler($fileLogger, ErrorLevel::WARNING);
$delegator->addErrorHandler($alertLogger, ErrorLevel::CRITICAL);

// Landet nur in der Datei
$delegator->warning('Quota bei 80 %');

// Landet in der Datei UND in Slack
$delegator->critical('Datenbank nicht erreichbar');

Methoden-Übersicht

Tags werden immer unter dem Schlüssel tags in den Log-Kontext gemergt. Bei exception() wird das Throwable zusätzlich unter exception eingetragen, damit PSR-3-Handler wie Monolog den Stack-Trace ausgeben können.