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 Wed, 04 Jan 2017 22:55:46 +0100 by phpDocumentor 1.4.3