axleus/axleus-log

Axleus Logging component

0.1.2 2026-05-03 23:26 UTC

Requires

• php: ~8.4.1 || ~8.5.0 || 8.6.0-dev
• laminas/laminas-component-installer: ^3.2
• laminas/laminas-hydrator: ^4.15.0
• monolog/monolog: ^3.4
• phly/phly-event-dispatcher: ^1.5.0
• ramsey/uuid: ^4.7

Requires (Dev)

• laminas/laminas-diactoros: ^3.5
• laminas/laminas-eventmanager: ^3.14
• laminas/laminas-i18n: ^2.31.0
• laminas/laminas-servicemanager: ^3.23.0 || ^4.0.0
• mezzio/mezzio: ^3.26
• mezzio/mezzio-authentication: ^1.13
• php-db/phpdb-mysql: 0.4.x-dev
• phpstan/phpstan: ^2.1
• phpstan/phpstan-phpunit: ^2.0
• phpunit/phpunit: ^13.0.0
• roave/security-advisories: dev-master
• tomasvotruba/type-coverage: ^2.1
• webware/coding-standard: ^0.1.0

Suggests

• php-db/phpdb-mysql: Required when using PhpDbHandler with a MySQL/MariaDB database

BSD-3-Clause

• Joey Smith

• monolog
• psr 3
• laminas
• mezzio
• axleus

README

This package provides logging via Monolog for Mezzio (PSR-15) applications. It provides log handlers backed by laminas-db or php-db/phpdb for writing logs to a database table. It also provides a PSR-14 event listener and a Laminas EventManager bridge listener for error logging.

Documentation

• Installation
• Configuration Reference
• Middleware
• Handlers
• Processors
• Event-Driven Logging (PSR-14)
• Error Logging

Quick Start

Install the package and let laminas-component-installer inject the ConfigProvider:

composer require axleus/axleus-log

Import the database schema and add the package's ConfigProvider to your config aggregator if not done automatically. Then pipe the middleware into your application pipeline:

// config/pipeline.php
$app->pipe(\Axleus\Log\Middleware\MonologMiddleware::class);

Enable optional features via config:

// config/autoload/log.local.php
use Psr\Log\LoggerInterface;

return [
    LoggerInterface::class => [
        'log_errors'     => true,  // auto-log uncaught exceptions
        'process_uuid'   => true,  // add UUID v7 to every record
        'channel'        => 'app', // LogChannel enum value
    ],
];

See the full documentation for details on all options, handlers, processors, and event-driven logging.