Monolog integration into Zend Framework 2
- PHP 5.4 or higher
- Monolog 1.11 or higher
- Zend Framework 2.3 or higher
MonologModule must be installed through Composer. For Composer documentation, please refer to getcomposer.org.
You can install the module from command line:
$ php composer.phar require neeckeloo/monolog-module:~0.1
Alternatively, you can also add manually the dependency in your composer.json
file:
{
"require": {
"neeckeloo/monolog-module": "~0.1"
}
}
Enable the module by adding MonologModule
key in your application.config.php
file.
This is the configuration of a logger that can be retrieved with key Log\App
in the service manager. A channel name default
is also defined to identify to which part of the application a record is related.
return [
'monolog' => [
'loggers' => [
'Log\App' => [
'name' => 'default',
],
],
],
];
The logger itself does not know how to handle a record. It delegates it to some handlers. The code above registers two handlers in the stack to allow handling records in two different ways.
return [
'monolog' => [
'loggers' => [
'Log\App' => [
'name' => 'default',
'handlers' => [
'stream' => [
'name' => 'Monolog\Handler\StreamHandler',
'options' => [
'path' => 'data/log/application.log',
'level' => \Monolog\Logger::DEBUG,
],
],
'fire_php' => [
'name' => 'Monolog\Handler\FirePHPHandler',
],
],
],
],
],
];
If you want to add extra information (tags, user IP, ...) to the records before they are handled, you should add some processors. The code above adds two processors that add an unique identifier and the current request URI, request method and client IP to a log record.
return [
'monolog' => [
'loggers' => [
'Log\App' => [
'name' => 'default',
'handlers' => [
'default' => [
'name' => 'Monolog\Handler\StreamHandler',
'options' => [
'path' => 'data/log/application.log',
'level' => \Monolog\Logger::DEBUG,
],
],
],
'processors' => [
'Monolog\Processor\UidProcessor',
'Monolog\Processor\WebProcessor',
],
],
],
],
];
Once the configuration is complete, you can retrieve an instance of the logger as below:
$logger = $serviceManager->get('Log\App');
$logger->debug('debug message');