hexanet/monolog-extra-bundle

Symfony bundle with extra processors and logger to log request/response

MonologExtraBundle

, _(*1)

Symfony bundle with extra processors and logger to log request/response., _(*2)

Installation

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:, _(*3)

$ composer require hexanet/monolog-extra-bundle

Applications that don't use Symfony Flex

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:, _(*4)

$ composer require hexanet/monolog-extra-bundle

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation., _(*5)

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:, _(*6)

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Hexanet\Common\MonologExtraBundle\HexanetMonologExtraBundle(),
        );
        // ...
    }

    // ...
}

Usage

Processors

The bundle provides several processors:, _(*7)

• User
• Session ID
• UID
• Additions

User

The UserProcessor add data about the current user in each log entry., _(*8)

hexanet_monolog_extra:
    processor:
        user: true

The default provider returns: * anonymous when no user is logged * the username of the current logged user * cli, _(*9)

You can create your own provider by creating a service that implements Hexanet\Common\MonologExtraBundle\Provider\User\UserProviderInterface., _(*10)

hexanet_monolog_extra:
    provider:
        user: your_own_provider_service_id

Session ID

Add the session id in each log entry., _(*11)

hexanet_monolog_extra:
    processor:
        session_id: true

You can create your own provider by creating a service that implements Hexanet\Common\MonologExtraBundle\Provider\Session\SessionIdProviderInterface., _(*12)

hexanet_monolog_extra:
    provider:
        session_id: your_own_provider_service_id

UID

Add an unique identifier for the request in each log entry., _(*13)

hexanet_monolog_extra:
    processor:
        uid: true

The bundle comes with 2 providers:, _(*14)

• UniqidProvider (default): use uniqid
• ApacheUniqueIdProvider: get from environment, need mod_unique_id of Apache

You can create your own provider by creating a service that implements Hexanet\Common\MonologExtraBundle\Provider\Uid\UidProviderInterface., _(*15)

hexanet_monolog_extra:
    provider:
        uid: your_own_provider_service_id

Additions

Add custom data in each log entry., _(*16)

hexanet_monolog_extra:
    processor:
        additions:
            type: symfony
            application: the best symfony application
            locale: "%locale%"
            environment: "%kernel.environment%"

Loggers

On request

Create a log entry with the request data., _(*17)

On response

Create a log entry with the response data., _(*18)

On console exception

Create a log entry when an exception occurs in console., _(*19)

Add UID to response

Add the UID of the previous processor in the response headers., _(*20)

HTTP/1.1 302 Found
X-UID: 57c5f5e842b10

Configuration reference

Configuration reference for a reference on the available configuration options., _(*21)

Credits

Developed by Hexanet., _(*22)

License

MonologExtraBundle is licensed under the MIT license., _(*23)