lombokclarion/log

Structured logging: levels, channels, handlers, formatters, and non-optional context redaction. No global logger and no static facade — a Logger is constructor-injected like every other service.

v2.1.0 2026-08-08 17:25 UTC

Requires

• php: >=8.3
• ext-json: *

Apache-2.0

• logging
• structured-logging
• lombokclarion

Published on Packagist.org on 2026-08-09 00:51 UTC

README

Structured logging: channels, handlers, formatters, context redaction.

[READ-ONLY] This is a subtree split of the LombokClarion monorepo.
Do not send pull requests here — contribute to the main repository instead.

Install

composer require lombokclarion/log

Namespace

LombokClarion\Log

What's Inside

Class	Role
Logger	Interface: log(LogLevel, string, array)
ChannelLogger	Multi-handler logger with channel name
NullLogger	No-op logger for testing
LogLevel	Enum: Debug, Info, Notice, Warning, Error, Critical, Alert, Emergency
LogRecord	Structured record VO (level, message, context, channel, timestamp)
LogHandler	Handler interface (decides whether to write)
LogFormatter	Formatter interface (record → string)
LogsConveniently	Trait: debug(), info(), warning(), error() sugar
Redactor	Redacts sensitive fields (password, token, secret, etc.)
StreamHandler	File handler with daily rotation + retention
InMemoryHandler	Testing handler (stores records in array)
LineFormatter	Human-readable single-line format
JsonFormatter	JSON structured format

Usage

use LombokClarion\Log\ChannelLogger;
use LombokClarion\Log\Handlers\StreamHandler;
use LombokClarion\Log\LogLevel;

$logger = new ChannelLogger([
    new StreamHandler(
        path: 'storage/logs/app.log',
        minimumLevel: LogLevel::Info,
        daily: true,
        retentionDays: 14,
    ),
], channel: 'app');

$logger->log(LogLevel::Info, 'User logged in', ['user_id' => 42]);

// Convenience methods (via LogsConveniently trait on ChannelLogger):
$logger->info('Order placed', ['order_id' => 99]);
$logger->error('Payment failed', ['reason' => 'timeout']);

Redaction

Sensitive fields (password, token, secret, authorization, cookie) are automatically redacted from log context.

License

Apache-2.0 — see LICENSE in the main repository.