Logger PSR-3 logger

Features

• Compatible with PSR-3 logger interface
• Multiple handlers support
• Exception logging support
• Multiple logging levels on application and handler level

Available commands

composer run phpunit
composer run phpstan
composer run style

Usage

use Proxity\Logger\Logger;
use Proxity\Logger\Handler\ConsoleHandler;
use Proxity\Logger\Level;

$logger = new Logger('channel',[new ConsoleHandler()]); //by default Level::Debug is set. You can override this like in the set call below.
$logger->setLevel(Level::Debug); 
$logger->addHandler(new ConsoleHandler());
$logger->debug('Log something for debug');

Logger output

5393    channel    Log something for debug    []      100     DEBUG  2023-05-09 15:02:41

When global level is passed to logger, all levels passed to handler will be ignored. In this example only Notice level will be output

use Proxity\Logger\Logger;
use Proxity\Logger\Handler\ConsoleHandler;

$logger = new Logger('btc', [new ConsoleHandler()], Level::Notice);
$logger->addHandler(new ConsoleHandler(Level::Debug));
$logger->addHandler(new ConsoleHandler(Level::Notice));
$logger->debug('Log something for debug');

When global level is not set, local level will be handled. Only notice will be handled

use Proxity\Logger\Logger;
use Proxity\Logger\Handler\ConsoleHandler;

$logger = new Logger('btc', [new ConsoleHandler()]);
$logger->addHandler(new ConsoleHandler(Level::Debug));
$logger->addHandler(new ConsoleHandler(Level::Notice));
$logger->notice('Log something for debug');

Extra points

Improvements

1. The app is not production ready. It does meet criteria given in the task however further work is required.
2. Introduce processors and apply before handlers to re-define given logRecord
3. User fibers for heavy processes. However, it will add extra complexity to the app
4. Add support for locked resources. Add lock component or apply wait&try mechanism and on general fail implement fall-back option
5. Improve formatters for clearer output eg. titles etc.
6. Potentially Logger::addRecord function can be optimized. It has O(n) complexity as it has to itterate over all handlers. Possible solution would be to narrow down handlers that are allowed to be used and then apply the logic: eg

$handlersToUse = [];

foreach ($this->handlers as $handler) {
    if ($handler->canHandle($record)) {
        $handlersToUse[] = $handler;
    }
}

foreach ($handlersToUse as $handler) {
    $handler->handle($record);
}

Complexity would be O(k) where k is the number of handlers "eligible" to handle current record