anekdotes/logger

A logger class to log JSON messages

Anekdotes Logger

, _(*1)

Allows logging of JSON messages, to easily be integrated in a static class., _(*2)

Installation

Install via composer into your project:, _(*3)

composer require anekdotes/logger

Basic Usage

To use the logger, call its namespace and build a context array., _(*4)

    use Anekdotes\Logger\Log;
    Log::info(["message" => "toaster","user_identification" => "4N3K"]);

Logging Drivers

The system logs to the PHP console by default. Setting a different driver will change its behavior, _(*5)

File Driver

To log to files, a FileDriver must be set., _(*6)

    use Anekdotes\Logger\Log;
    use Anekdotes\Logger\Drivers\FileDriver;
    //Set Driver and use it
    Log::setDriver(new FileDriver('logname','tmp/logs/toaster.log'));
    Log::info(["message" => "toaster","user_identification" => "4N3K"]);

Console Driver

Logs a file to the PHP Console. Used by default, but this can be used if another driver was previously set, _(*7)

    use Anekdotes\Logger\Log;
    use Anekdotes\Logger\Drivers\FileDriver;
    //Set Driver and use it
    Log::setDriver(new ConsoleDriver()); 
    Log::info(["message" => "toaster","user_identification" => "4N3K"]);

Handlers

You can use handlers to have the logger run additional tasks on error and critical logs. Handlers are Anonymous functions that are set by using their accessors., _(*8)

    $data = ["data" => "data"];
    $functionThatLogsIntoDatabase = function () use ($data) { 
      //Log $data in the database 
    };
    Log::setErrorHandler($functionThatLogsIntoDatabase);
    Log::error($data);

The handlers can also use the data that will be provided to the logfile and send it to the Closure., _(*9)

    $data = ["data" => "data"];
    $functionThatLogsIntoDatabase = function ($LogData) {
      //Log $LogData in the DB. Note the LogData is the exact output that will be saved to a file. It is in JSON Format. 
    };
    Log::setCriticalHandler($functionThatLogsIntoDatabase);
    Log::critical($data);

Logging Levels

You can use the following levels of logging as calls:, _(*10)

    Log::info([]);
    Log::success([]);
    Log::warn([]);
    Log::error([]);
    Log::critical([]);