symfony/monolog-bundle v3.10.0

The symfony/monolog-bundle is an integral package in Symfony that facilitates the utilization of the Monolog library. Monolog is a PHP-based logging library, and this bundle's function is to integrate it smoothly into the Symfony framework. That can significantly enhance your ability to log messages, errors, or even structured data, providing you with necessary insights and helping debug your application easily and effectively.

To use the symfony/monolog-bundle in your project, you need to follow these steps.

• First, install it using Composer by running:

composer require symfony/monolog-bundle

• To configure the logging channels and handlers, use YAML-based configuration in your application's config file:

# config/packages/monolog.yaml
monolog:
    channels: ["my_channel"]
    handlers:
        my_handler:
            type:  stream
            path:  "%kernel.logs_dir%/my_channel.log"
            level: debug
            channels: ["my_channel"]

Please note that in this example, a new log channel named 'my_channel' is being generated. It is configured to use a handler 'my_handler' that logs the messages into a file my_channel.log and the log level specified is 'debug'.

• After the configuration stage, the logger service can be injected into any services or controllers as per the need. Below is an example on how to use it in a controller:

<?php

namespace App\Controller;

use Psr\Log\LoggerInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;

class DefaultController extends AbstractController
{
    public function index(LoggerInterface $myChannelLogger): Response
    {
        $myChannelLogger->info('I just logged in!');

        return $this->render('default/index.html.twig');
    }
}

Here, 'myChannelLogger' is our custom log channel injected into the 'index' action of 'DefaultController'. And we're logging an info message saying 'I just logged in!'.

Please keep in mind that these are basic usage examples. It's possible to utilize different channels, handlers, and log levels for a more complex setup.

The primary source for the symfony/monolog-bundle's documentation is found on the official Symfony website. You can access detailed information about its usage, configuration, and features from Symfony Documentation. Additionally, for more information about Monolog itself and its capabilities, visiting the Monolog GitHub repository would be beneficial.