Source for file jLog.class.php

Documentation is available at jLog.class.php

<?php
/**
* @package jelix
* @subpackage core
* @author Laurent Jouanneau
* @contributor F. Fernandez, Hadrien Lanneau
* @copyright 2006-2012 Laurent Jouanneau, 2007 F. Fernandez, 2011 Hadrien Lanneau
* @link http://www.jelix.org
* @licence GNU Lesser General Public Licence see LICENCE file or http://www.gnu.org/licenses/lgpl.html
*/
/**
* interface for log message. A component which want to log
* a message can use an object implementing this interface.
* Classes that implements it are responsible to format
* the message. Formatting a message depends on its type.
*/
interface jILogMessage {
/**
* return the category of the message
* @return string category name
*/
public function getCategory();
/**
* @return string the message
*/
public function getMessage();
/**
* return the full message, formated for simple text output (it can contain informations
* other than the message itself)
* @return string the message
*/
public function getFormatedMessage();
}
require(JELIX_LIB_CORE_PATH.'log/jLogMessage.class.php');
require(JELIX_LIB_CORE_PATH.'log/jLogErrorMessage.class.php');
/**
* interface for loggers
*/
interface jILogger {
/**
* @param jILogMessage $message the message to log
*/
function logMessage($message);
/**
* output messages to the given response
* @param jResponse $response
*/
function output($response);
}
require(JELIX_LIB_CORE_PATH.'log/jFileLogger.class.php');
/**
* utility class to log some message into a file into yourapp/var/log
* @package jelix
* @subpackage utils
* @static
*/
class jLog {
protected static $loggers = array();
/**
* all messages, when the memory logger is used
* @var array array of jILogMessage
*/
protected static $allMessages = array();
/**
* messages count of each categories, for the memory logger
*/
protected static $messagesCount = array();
/**
* private constructor. static class
*/
private function __construct(){}
/**
* log a dump of a php value (object or else) into the given category
* @param mixed $obj the value to dump
* @param string $label a label
* @param string $category the message category
*/
public static function dump($obj, $label='', $category='default'){
$message = new jLogDumpMessage($obj, $label, $category);
self::_dispatchLog($message);
}
/**
* log a message into the given category.
* Warning: since it is called by error handler, it should not trigger errors!
* and should take care of case were an error could appear
* @param mixed $message
* @param string $category the log type
*/
public static function log ($message, $category='default') {
if (!is_object($message) || ! $message instanceof jILogMessage)
$message = new jLogMessage($message, $category);
self::_dispatchLog($message);
}
/**
* log an exception into the given category.
* @param Exception $exception
* @param string $category the log type
*/
public static function logEx ($exception, $category='default') {
$message = new jLogErrorMessage($category,
$exception->getCode(), $exception->getMessage(),
$exception->getFile(), $exception->getLine(),
$exception->getTrace());
self::_dispatchLog($message);
}
protected static function _dispatchLog($message) {
$confLoggers = &jApp::config()->logger;
$category = $message->getCategory();
if (!isset($confLoggers[$category])
|| strpos($category, 'option_') === 0) { // option_* are not some type of log messages
$category = 'default';
}
$all = $confLoggers['_all'];
$loggers = preg_split('/[\s,]+/', $confLoggers[$category]);
if ($all != '') {
$allLoggers = preg_split('/[\s,]+/', $all);
self::_log($message, $allLoggers);
$loggers = array_diff($loggers, $allLoggers);
}
self::_log($message, $loggers);
}
protected static function _log($message, $loggers) {
// let's inject the message in all loggers
foreach($loggers as $loggername) {
if ($loggername == '')
continue;
if ($loggername == 'memory') {
$confLog = &jApp::config()->memorylogger;
$cat = $message->getCategory();
if (isset($confLog[$cat]))
$max = intval($confLog[$cat]);
else {
$max = intval($confLog['default']);
}
if (!isset(self::$messagesCount[$cat])) {
self::$messagesCount[$cat] = 0;
}
if(++self::$messagesCount[$cat] > $max) {
continue;
}
self::$allMessages[] = $message;
continue;
}
if(!isset(self::$loggers[$loggername])) {
if ($loggername == 'file')
self::$loggers[$loggername] = new jFileLogger();
elseif ($loggername == 'syslog') {
require(JELIX_LIB_CORE_PATH.'log/jSyslogLogger.class.php');
self::$loggers[$loggername] = new jSyslogLogger();
}
elseif ($loggername == 'mail') {
require(JELIX_LIB_CORE_PATH.'log/jMailLogger.class.php');
self::$loggers[$loggername] = new jMailLogger();
}
else {
$l = jApp::loadPlugin($loggername, 'logger', '.logger.php', $loggername.'Logger');
if (is_null($l))
continue; // yes, silent, because we could be inside an error handler
self::$loggers[$loggername] = $l;
}
}
self::$loggers[$loggername]->logMessage($message);
}
}
/**
* returns messages stored in memory (if the memory logger is activated)
* @param string|array$filter if given, category or list of categories
* of messages you want to retrieve
* @return array the list of jILogMessage object
*/
public static function getMessages($filter = false) {
if ($filter === false || self::$allMessages === null)
return self::$allMessages;
if (is_string ($filter))
$filter = array($filter);
$list = array();
foreach(self::$allMessages as $msg) {
if (in_array($msg->getCategory(), $filter))
$list[] = $msg;
}
return $list;
}
/**
* @return integer
*/
static function getMessagesCount($category) {
if (isset(self::$messagesCount[$category])) {
return self::$messagesCount[$category];
}
return 0;
}
/**
* call each loggers so they have the possibility to inject data into the
* given response
* @param jResponse $response
*/
public static function outputLog($response) {
foreach(self::$loggers as $logger) {
$logger->output($response);
}
}
/**
* indicate if, for the given category, the given logger is activated
* @param string $logger the logger name
* @param string $category the category
* @return boolean true if it is activated
*/
public static function isPluginActivated($logger, $category) {
$confLog = &jApp::config()->logger;
$loggers = preg_split('/[\s,]+/', $confLog['_all']);
if (in_array($logger, $loggers))
return true;
if (!isset($confLog[$category]))
return false;
$loggers = preg_split('/[\s,]+/', $confLog[$category]);
return in_array($logger, $loggers);
}
}

Documentation generated on Mon, 26 Oct 2015 21:55:06 +0100 by phpDocumentor 1.4.3