README

Logging support for the app using the Monolog library.

Getting Started
- Requirements
Documentation
Credits

Getting Started

Add the latest version of the app logging project running this command.

composer require tobento/app-logging

Requirements

PHP 8.0 or greater

Documentation

App

Check out the App Skeleton if you are using the skeleton.

You may also check out the App to learn more about the app in general.

Logging Boot

The logging boot does the following:

installs and loads logging config file
implements logging interfaces

use Tobento\App\AppFactory;
use Tobento\App\Logging\LoggersInterface;
use Psr\Log\LoggerInterface;

// Create the app
$app = (new AppFactory())->createApp();

// Add directories:
$app->dirs()
    ->dir(realpath(__DIR__.'/../'), 'root')
    ->dir(realpath(__DIR__.'/../app/'), 'app')
    ->dir($app->dir('app').'config', 'config', group: 'config')
    ->dir($app->dir('root').'public', 'public')
    ->dir($app->dir('root').'vendor', 'vendor');

// Adding boots
$app->boot(\Tobento\App\Logging\Boot\Logging::class);
$app->booting();

// Implemented interfaces:
$logger = $app->get(LoggerInterface::class);
$loggers = $app->get(LoggersInterface::class);

// Run the app
$app->run();

Logging Config

The configuration for the logging is located in the app/config/logging.php file at the default App Skeleton config location where you can specify the loggers for your application.

The Lazy Loggers is used for the loggers.

Logger Trait

You may use the logger trait to quickly access a logger instance and log messages:

use Tobento\App\Logging\LoggerTrait;

class SomeService
{
    use LoggerTrait;

    public function someAction(): void
    {
        $this->getLogger()->info('Some info');
        // is same as:
        $this->getLogger(name: static::class)->info('Some info');
        // if the named logger does not exists,
        // the default logger will be used.
        
        // or using another named logger:
        $this->getLogger(name: 'daily')->info('Some info');
    }
}

Next, you may define the logger used for your service.

In the Logging Config file, define your service class and the logger you want to use:

/*
|--------------------------------------------------------------------------
| Aliases
|--------------------------------------------------------------------------
*/

'aliases' => [
    SomeService::class => 'daily',
],

Alternatively, you may request the LoggersInterface::class from your app or inject it in any class and use the addAlias method:

use Tobento\App\Logging\LoggersInterface;

$app->get(LoggersInterface::class)->addAlias(alias: SomeService::class, logger: 'daily');

Loggers

Lazy Loggers

The LazyLoggers::class creates the loggers only on demand.

use Tobento\App\Logging\LazyLoggers;
use Tobento\App\Logging\LoggerFactoryInterface;
use Tobento\App\Logging\LoggersInterface;
use Tobento\App\Logging\StackLoggerFactory;
use Psr\Container\ContainerInterface;
use Psr\Log\LoggerInterface;
use Psr\Log\NullLogger;

$loggers = new LazyLoggers(
    container: $container, // ContainerInterface
    loggers: [
        // using a closure:
        'daily' => static function (string $name, ContainerInterface $c): LoggerInterface {
            // create logger ...
            return $logger;
        },
        
        // using a factory:
        'stacked' => [
            // factory must implement LoggerFactoryInterface
            'factory' => StackLoggerFactory::class,
            'config' => [
                'loggers' => ['daily', 'another'],
            ],
        ],
        
        // or you may sometimes just create a logger (not lazy):
        'null' => new NullLogger(),
    ],
);

var_dump($loggers instanceof LoggersInterface);
// bool(true)

Check out the Logger Factories section for the available logger factories.

Check out the Loggers Interface section to learn more about it.

Logger Factories

Stack Logger Factory

The StackLoggerFactory::class creates a stack logger with the specified loggers.

use Tobento\App\Logging\StackLoggerFactory;
use Tobento\App\Logging\LoggerFactoryInterface;
use Tobento\App\Logging\LoggersInterface;

$factory = new StackLoggerFactory(
    loggers: $loggers // LoggersInterface
);

var_dump($factory instanceof LoggerFactoryInterface);
// bool(true)

Check out the Loggers section for the available loggers.

Create logger

use Psr\Log\LoggerInterface;
use Tobento\App\Logging\StackLogger;

$logger = $factory->createLogger(name: 'stacked', config: [
    // specify the loggers you want to be stacked:
    'loggers' => ['daily', 'syslog'],
]);

var_dump($logger instanceof LoggerInterface);
// bool(true)

var_dump($logger instanceof StackLogger);
// bool(true)

Events

Available Events

use Tobento\App\Logging\Event;

Events Support

You may add the EventHandler::class in the Logging Config file and install the App Event bundle to support events.

use Tobento\App\Logging\Monolog\EventHandler;
use Psr\Container\ContainerInterface;
use Psr\Log\LoggerInterface;

'loggers' => [

    'daily' => static function (string $name, ContainerInterface $c): LoggerInterface {
        return new Logger(
            name: $name,
            handlers: [
                // support events:
                $c->get(EventHandler::class),
            ],
        );
    },
],

Interfaces

Loggers Interface

Check out the available Loggers implementing the Tobento\App\Logging\LoggersInterface::class.

add

With the add method you can add a new logger:

use Psr\Log\LoggerInterface;

$loggers->add(name: 'daily', logger: $logger); // LoggerInterface

// or using a closure:
$loggers->add(name: 'daily', logger: static function (): LoggerInterface {
    return $createdLogger;
});

addAlias

With the addAlias method you can add an alias for the specified logger:

$loggers->addAlias(alias: 'alias', logger: 'daily');

// get a logger by an alias:
$logger = $loggers->get('alias');
// returns the 'daily' logger if exists.

aliases

The aliases method returns the added aliases:

$loggers->addAlias(alias: 'alias', logger: 'daily');

$aliases = $loggers->aliases();
// ['alias' => 'daily']

logger

The logger method returns a logger:

use Psr\Log\LoggerInterface;

// get the default logger:
$logger = $loggers->logger();

// get a named logger:
$logger = $loggers->logger(name: 'daily');

// get an aliased logger:
$logger = $loggers->logger(name: 'alias');

var_dump($logger instanceof LoggerInterface);
// bool(true)

get

The get method returns a logger if exists, otherwise null:

use Psr\Log\LoggerInterface;

// get a named logger:
$logger = $loggers->get(name: 'daily');

// get an aliased logger:
$logger = $loggers->get(name: 'alias');

var_dump($logger instanceof LoggerInterface);
// bool(true) or NULL if not exist

has

The has method returns true if the logger exists, otherwise false:

$has = $loggers->has(name: 'daily');

// with an alias:
$has = $loggers->has(name: 'alias');

names

The names method returns all logger names:

$names = $loggers->names();

var_dump($names);
// array(1) {[0]=> string(5) "daily"}

created

The created method returns all created loggers which may be used to reset or clear loggers:

use Psr\Log\LoggerInterface;

$loggers = $loggers->created();
// array<string, LoggerInterface>

Logger Factory Interface

Check out the available Logger Factories implementing the Tobento\App\Logging\LoggerFactoryInterface::class.

createLogger

The createLogger method creates a new logger instance based on the configuration:

use Psr\Log\LoggerInterface;

$logger = $loggerFactory->createLogger(
    name: 'stacked', // a logger name
    config: [], // any data for creating the logger
);

var_dump($logger instanceof LoggerInterface);
// bool(true)

tobento / app-logging

Maintainers

Details