cognesy / logging

v2.9.5 2026-08-30 01:03 UTC

Requires

• php: ^8.3
• cognesy/instructor-config: ^2.9
• cognesy/instructor-events: ^2.9
• psr/log: ^3.0

Requires (Dev)

• icanhazstring/composer-unused: ^0.9.0
• illuminate/contracts: ^11.0
• illuminate/support: ^11.0
• jetbrains/phpstorm-attributes: ^1.2
• maglnet/composer-require-checker: ^4.16
• monolog/monolog: ^3.0
• pestphp/pest: ^4.0
• phpstan/phpstan: ^1.11
• roave/security-advisories: dev-latest
• symfony/dependency-injection: ^7.0
• symfony/event-dispatcher: ^7.0
• symfony/http-kernel: ^7.0
• vimeo/psalm: ^6.0

MIT

• Dariusz Debowczyk

Published on Packagist.org on 2026-08-30 02:04 UTC

README

Functional logging pipeline for InstructorPHP events.

Use it to turn events into structured log entries using composable:

• filters
• enrichers
• formatters
• writers

Symfony integration is included.

Framework integration wiring is explicit in 2.0:

• Laravel integration lives in packages/laravel.
• Symfony legacy bundle wiring uses instructor_logging.event_bus_service (default Cognesy\Events\Contracts\CanHandleEvents).
• The legacy Symfony bundle path is deprecated in favor of cognesy/instructor-symfony and instructor.logging.

Example

<?php

use Cognesy\Events\Event;
use Cognesy\Logging\Enrichers\BaseEnricher;
use Cognesy\Logging\Filters\LogLevelFilter;
use Cognesy\Logging\Formatters\DefaultFormatter;
use Cognesy\Logging\LogEntry;
use Cognesy\Logging\Pipeline\LoggingPipeline;
use Cognesy\Logging\Writers\CallableWriter;
use Psr\Log\LogLevel;

$pipeline = LoggingPipeline::create()
    ->filter(new LogLevelFilter(LogLevel::INFO))
    ->enrich(new BaseEnricher())
    ->format(new DefaultFormatter())
    ->write(CallableWriter::create(function (LogEntry $entry): void {
        error_log($entry->message);
    }))
    ->build();

$pipeline(new Event(['operation' => 'demo']));

Documentation

• packages/logging/CHEATSHEET.md
• packages/logging/src/
• packages/logging/tests/