README

A lightweight, composable logging toolkit for PHP that implements the PSR‑3 LoggerInterface and lets you build flexible pipelines. Combine output loggers (e.g., streams, syslog) with formatters, filters, and extenders to shape messages, enrich context, and route by severity. Includes an ExtendedLogger for hierarchical captions and execution scopes.

Quick taste

use Logger\Builder;
use Logger\Formatters\TemplateFormatter;
use Logger\Loggers\ResourceLogger;
use Psr\Log\LoggerInterface;

$logger = Builder::chain(
    ResourceLogger::outputToStdOut(),
    fn (LoggerInterface $l) => new TemplateFormatter($l)
);

$logger->info('Hello world', ['id' => 42]);

Component overview

• Common — ExtendedLogger for hierarchical captions and contextual scopes.
• Formatters — Render and transform messages (Template, DateTime, Prefix, JSON, etc.).
• Filters — Pass/drop by rules (min/max/range level, callbacks, regex).
• Loggers — Output sinks: streams, syslog, callbacks, in‑memory array.
• Extenders — Side‑effect hooks and enrichment (context, stacktrace, metrics).
• Manipulators — Adjust semantics like compressing log levels.

How it differs from other logging solutions:

• Monolog
• KLogger
• Log4PHP