WP Monolog
WordPress plugin that enables logging capabilities for theme and/or plugin development.
Description
WP Monolog is a very lightweight plugin which purpose is to integrate Monolog into WordPress, allowing theme or plugin developers to log messages to files, for debugging purposes, or to email, to alert on failures.
Usage
A global variable named $logger is available and it's an instance of Monolog\Logger, so you can use it as you would normally use monolog:
<?php
global $logger;
$logger->addInfo("An info message");
$logger->addWarning("A warning message");
$logger->addError("An error message");Info logs will be sent to the 'default' stream handler, which is a log file available at wp-content/plugins/wp-monolog/log/yy-mm-dd_wp_monolog.log.
Error logs will be sent by email to the site administrator. You can change this on the settings page of the plugin. WordPress Admin > Tools > WP Monolog
Another global variable exists which is $wp_monolog, this instance is helpful at the moment to get new Monolog\Logger instances on demand. This is useful for example when you have different features spread across your theme or plugins and you want to create specific log records per feature for better error/warning/info tracking.
Example:
<?php
function greet(){
global $wp_monolog;
$greet_logger = $wp_monolog->getLoggerInstance('GreetLog');
try{
$greet_logger->addInfo('About to greet');
sayHello();
} catch ( Exception $e ){
$greet_logger->addError('Oops, something went wrong with the greeting message');
}
}
function replyGreeting(){
global $wp_monolog;
$reply_greeting_logger = $wp_monolog->getLoggerInstance('ReplyGreetingLog');
$reply_greeting_logger->addInfo('Replying greeting');
echo "Hello yourself!";
}The above examples will result in a log record similar to this (in order of appearance):
[yyyy-mm-dd hh:ii:ss] GreetLog.INFO: Message: About to greet
[yyyy-mm-dd hh:ii:ss] GreetLog.ERROR: Message: Oops, something went wrong with the greeting message
[yyyy-mm-dd hh:ii:ss] ReplyGreetingLog.INFO: Message: Replying greeting