Current File : /home/admin/domains/happytokorea.com/public_html_bk/test2/libraries/joomla/log/log.php
<?php
/**
* @package Joomla.Platform
* @subpackage Log
*
* @copyright Copyright (C) 2005 - 2014 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE
*/
defined('JPATH_PLATFORM') or die;
/**
* Joomla! Log Class
*
* This class hooks into the global log configuration settings to allow for user configured
* logging events to be sent to where the user wishes them to be sent. On high load sites
* Syslog is probably the best (pure PHP function), then the text file based loggers (CSV, W3c
* or plain Formattedtext) and finally MySQL offers the most features (e.g. rapid searching)
* but will incur a performance hit due to INSERT being issued.
*
* @package Joomla.Platform
* @subpackage Log
* @since 11.1
*/
class JLog
{
/**
* All log priorities.
* @var integer
* @since 11.1
*/
const ALL = 30719;
/**
* The system is unusable.
* @var integer
* @since 11.1
*/
const EMERGENCY = 1;
/**
* Action must be taken immediately.
* @var integer
* @since 11.1
*/
const ALERT = 2;
/**
* Critical conditions.
* @var integer
* @since 11.1
*/
const CRITICAL = 4;
/**
* Error conditions.
* @var integer
* @since 11.1
*/
const ERROR = 8;
/**
* Warning conditions.
* @var integer
* @since 11.1
*/
const WARNING = 16;
/**
* Normal, but significant condition.
* @var integer
* @since 11.1
*/
const NOTICE = 32;
/**
* Informational message.
* @var integer
* @since 11.1
*/
const INFO = 64;
/**
* Debugging message.
* @var integer
* @since 11.1
*/
const DEBUG = 128;
/**
* The global JLog instance.
* @var JLog
* @since 11.1
*/
protected static $instance;
/**
* Container for JLogLogger configurations.
* @var array
* @since 11.1
*/
protected $configurations = array();
/**
* Container for JLogLogger objects.
* @var array
* @since 11.1
*/
protected $loggers = array();
/**
* Lookup array for loggers.
* @var array
* @since 11.1
*/
protected $lookup = array();
/**
* Constructor.
*
* @since 11.1
*/
protected function __construct()
{
}
/**
* Method to add an entry to the log.
*
* @param mixed $entry The JLogEntry object to add to the log or the message for a new JLogEntry object.
* @param integer $priority Message priority.
* @param string $category Type of entry
* @param string $date Date of entry (defaults to now if not specified or blank)
*
* @return void
*
* @since 11.1
*/
public static function add($entry, $priority = self::INFO, $category = '', $date = null)
{
// Automatically instantiate the singleton object if not already done.
if (empty(self::$instance))
{
self::setInstance(new JLog);
}
// If the entry object isn't a JLogEntry object let's make one.
if (!($entry instanceof JLogEntry))
{
$entry = new JLogEntry((string) $entry, $priority, $category, $date);
}
self::$instance->addLogEntry($entry);
}
/**
* Add a logger to the JLog instance. Loggers route log entries to the correct files/systems to be logged.
*
* @param array $options The object configuration array.
* @param integer $priorities Message priority
* @param array $categories Types of entry
* @param boolean $exclude If true, all categories will be logged except those in the $categories array
*
* @return void
*
* @since 11.1
*/
public static function addLogger(array $options, $priorities = self::ALL, $categories = array(), $exclude = false)
{
// Automatically instantiate the singleton object if not already done.
if (empty(self::$instance))
{
self::setInstance(new JLog);
}
// The default logger is the formatted text log file.
if (empty($options['logger']))
{
$options['logger'] = 'formattedtext';
}
$options['logger'] = strtolower($options['logger']);
// Special case - if a Closure object is sent as the callback (in case of JLogLoggerCallback)
// Closure objects are not serializable so swap it out for a unique id first then back again later
if (isset($options['callback']) && is_a($options['callback'], 'closure'))
{
$callback = $options['callback'];
$options['callback'] = spl_object_hash($options['callback']);
}
// Generate a unique signature for the JLog instance based on its options.
$signature = md5(serialize($options));
// Now that the options array has been serialized, swap the callback back in
if (isset($callback))
{
$options['callback'] = $callback;
}
// Register the configuration if it doesn't exist.
if (empty(self::$instance->configurations[$signature]))
{
self::$instance->configurations[$signature] = $options;
}
self::$instance->lookup[$signature] = (object) array(
'priorities' => $priorities,
'categories' => array_map('strtolower', (array) $categories),
'exclude' => (bool) $exclude);
}
/**
* Returns a reference to the a JLog object, only creating it if it doesn't already exist.
* Note: This is principally made available for testing and internal purposes.
*
* @param JLog $instance The logging object instance to be used by the static methods.
*
* @return void
*
* @since 11.1
*/
public static function setInstance($instance)
{
if (($instance instanceof JLog) || $instance === null)
{
self::$instance = & $instance;
}
}
/**
* Method to add an entry to the appropriate loggers.
*
* @param JLogEntry $entry The JLogEntry object to send to the loggers.
*
* @return void
*
* @since 11.1
* @throws RuntimeException
*/
protected function addLogEntry(JLogEntry $entry)
{
// Find all the appropriate loggers based on priority and category for the entry.
$loggers = $this->findLoggers($entry->priority, $entry->category);
foreach ((array) $loggers as $signature)
{
// Attempt to instantiate the logger object if it doesn't already exist.
if (empty($this->loggers[$signature]))
{
$class = 'JLogLogger' . ucfirst($this->configurations[$signature]['logger']);
if (class_exists($class))
{
$this->loggers[$signature] = new $class($this->configurations[$signature]);
}
else
{
throw new RuntimeException('Unable to create a JLogLogger instance: ' . $class);
}
}
// Add the entry to the logger.
$this->loggers[$signature]->addEntry(clone($entry));
}
}
/**
* Method to find the loggers to use based on priority and category values.
*
* @param integer $priority Message priority.
* @param string $category Type of entry
*
* @return array The array of loggers to use for the given priority and category values.
*
* @since 11.1
*/
protected function findLoggers($priority, $category)
{
$loggers = array();
// Sanitize inputs.
$priority = (int) $priority;
$category = strtolower($category);
// Let's go iterate over the loggers and get all the ones we need.
foreach ((array) $this->lookup as $signature => $rules)
{
// Check to make sure the priority matches the logger.
if ($priority & $rules->priorities)
{
if ($rules->exclude)
{
// If either there are no set categories or the category (including the empty case) is not in the list of excluded categories, add this logger.
if (empty($rules->categories) || !in_array($category, $rules->categories))
{
$loggers[] = $signature;
}
}
else
{
// If either there are no set categories (meaning all) or the specific category is set, add this logger.
if (empty($category) || empty($rules->categories) || in_array($category, $rules->categories))
{
$loggers[] = $signature;
}
}
}
}
return $loggers;
}
}