koded/logging

A simple standalone logging facility with several log processors

Koded - Logging Library

A simple message logging library that implements PSR-3 with several log processors. It supports multiple log writers that can be set separately and process messages based on the log level., _(*1)

, _(*2)

Installation

Use composer and run, _(*3)

composer require koded/logging, _(*4)

or add it manually in your current composer.json, _(*5)

{
  "require": {
    "koded/logging": "^3"
  }
}

Usage

<?php

$settings = [
    [
        ['class' => Cli::class, 'levels' => Log::ERROR],
        ['class' => File::class, 'levels' => Log::INFO]
    ]
];

$log = new Log(...$settings);

// This message is processed by Cli and File
$log->alert('The message with {variable}', ['variable' => 'useful info']);

// This message won't be processed by Cli 
// because it's level is below ERROR,
// but File will handle it
$log->warning("You don't see anything");

Configuration

Processor default directives

Every log processor has it's own set of configuration directives.
The table shows log parameters in the classes., _(*6)

Levels example

The messages are filtered with bitwise operator against the levels value. Every processor will filter out the messages as defined in it's levels directive., _(*7)

For instance, to log only WARNING, INFO and ERROR messages, set levels to, _(*8)

<?php

[..., ['levels' => Log::WARN | Log::INFO | Log::ERROR, ...]],

Tips: - every processor is configured separately - if you want to process all log levels, skip the levels value or set it to -1 (by default) - if you want to suppress a specific processor, set it's level to 0, _(*9)

Processors

Benchmarks and tests

shell script vendor/bin/phpbench run --report=default vendor/bin/phpunit, _(*10)

License

The code is distributed under the terms of The 3-Clause BSD license., _(*11)