If this method returns true, meaning that layout is required, + * then the configurator will configure a layout using the configuration + * information at its disposal. If this method returns false, + * meaning that a layout is not required, then layout configuration will be + * skipped even if there is available layout configuration + * information at the disposal of the configurator.
+ * + *In the rather exceptional case, where the appender + * implementation admits a layout but can also work without it, then + * the appender should return true.
+ * + * @return boolean + */ + abstract public function requiresLayout(); + +} diff --git a/thirdparty/apache-log4php/src/main/php/LoggerAppenderSkeleton.php b/thirdparty/apache-log4php/src/main/php/LoggerAppenderSkeleton.php new file mode 100644 index 0000000..2a14371 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/LoggerAppenderSkeleton.php @@ -0,0 +1,337 @@ +name = $name; + $this->clearFilters(); + } + + /** + * @param LoggerFilter $newFilter add a new LoggerFilter + * @see LoggerAppender::addFilter() + */ + public function addFilter($newFilter) { + if($this->headFilter === null) { + $this->headFilter = $newFilter; + $this->tailFilter = $this->headFilter; + } else { + $this->tailFilter->next = $newFilter; + $this->tailFilter = $this->tailFilter->next; + } + } + + /** + * Derived appenders should override this method if option structure + * requires it. + */ + abstract public function activateOptions(); + + /** + * Subclasses of {@link LoggerAppenderSkeleton} should implement + * this method to perform actual logging. + * + * @param LoggerLoggingEvent $event + * @see doAppend() + * @abstract + */ + abstract protected function append($event); + + /** + * @see LoggerAppender::clearFilters() + */ + public function clearFilters() + { + unset($this->headFilter); + unset($this->tailFilter); + $this->headFilter = null; + $this->tailFilter = null; + } + + /** + * Finalize this appender by calling the derived class' close() method. + */ + public function finalize() + { + // An appender might be closed then garbage collected. There is no + // point in closing twice. + if ($this->closed) return; + + LoggerLog::debug("LoggerAppenderSkeleton::finalize():name=[{$this->name}]."); + + $this->close(); + } + + /** + * Do not use this method. + * @see LoggerAppender::getErrorHandler() + * @return object + */ + public function getErrorHandler() + { + return $this->errorHandler; + } + + /** + * @see LoggerAppender::getFilter() + * @return LoggerFilter + */ + public function getFilter() + { + return $this->headFilter; + } + + /** + * Return the first filter in the filter chain for this Appender. + * The return value may be null if no is filter is set. + * @return LoggerFilter + */ + public function getFirstFilter() + { + return $this->headFilter; + } + + /** + * @see LoggerAppender::getLayout() + * @return LoggerLayout + */ + public function getLayout() + { + return $this->layout; + } + + /** + * @see LoggerAppender::getName() + * @return string + */ + public function getName() + { + return $this->name; + } + + /** + * Returns this appenders threshold level. + * See the {@link setThreshold()} method for the meaning of this option. + * @return LoggerLevel + */ + public function getThreshold() + { + return $this->threshold; + } + + /** + * Check whether the message level is below the appender's threshold. + * + * + * If there is no threshold set, then the return value is always true. + * @param LoggerLevel $priority + * @return boolean true if priority is greater or equal than threshold + */ + public function isAsSevereAsThreshold($priority) + { + if ($this->threshold === null) + return true; + + return $priority->isGreaterOrEqual($this->getThreshold()); + } + + /** + * @see LoggerAppender::doAppend() + * @param LoggerLoggingEvent $event + */ + public function doAppend($event) + { + LoggerLog::debug("LoggerAppenderSkeleton::doAppend()"); + + if ($this->closed) { + LoggerLog::debug("LoggerAppenderSkeleton::doAppend() Attempted to append to closed appender named [{$this->name}]."); + return; + } + if(!$this->isAsSevereAsThreshold($event->getLevel())) { + LoggerLog::debug("LoggerAppenderSkeleton::doAppend() event level is less severe than threshold."); + return; + } + + $f = $this->getFirstFilter(); + + while($f !== null) { + switch ($f->decide($event)) { + case LOG4PHP_LOGGER_FILTER_DENY: return; + case LOG4PHP_LOGGER_FILTER_ACCEPT: return $this->append($event); + case LOG4PHP_LOGGER_FILTER_NEUTRAL: $f = $f->getNext(); + } + } + $this->append($event); + } + + + /** + * @see LoggerAppender::requiresLayout() + * @return boolean + */ + public function requiresLayout() + { + return $this->requiresLayout; + } + + /** + * @see LoggerAppender::setErrorHandler() + * @param object + */ + public function setErrorHandler($errorHandler) + { + if($errorHandler == null) { + // We do not throw exception here since the cause is probably a + // bad config file. + LoggerLog::warn("You have tried to set a null error-handler."); + } else { + $this->errorHandler = $errorHandler; + } + } + + /** + * @see LoggerAppender::setLayout() + * @param LoggerLayout $layout + */ + public function setLayout($layout) + { + if ($this->requiresLayout()) + $this->layout = $layout; + } + + /** + * @see LoggerAppender::setName() + * @param string $name + */ + public function setName($name) + { + $this->name = $name; + } + + /** + * Set the threshold level of this appender. + * + * @param mixed $threshold can be a {@link LoggerLevel} object or a string. + * @see LoggerOptionConverter::toLevel() + */ + public function setThreshold($threshold) + { + if (is_string($threshold)) { + $this->threshold = LoggerOptionConverter::toLevel($threshold, null); + }elseif ($threshold instanceof LoggerLevel) { + $this->threshold = $threshold; + } + } + + /** + * Perform actions before object serialization. + * + * Call {@link finalize()} to properly close the appender. + */ + function __sleep() + { + $this->finalize(); + return array_keys(get_object_vars($this)); + } + + /** + * Perform actions after object de-serialization. + * + * Call {@link activateOptions()} to properly setup the appender. + */ + function __wakeup() + { + $this->activateOptions(); + } + +} diff --git a/thirdparty/apache-log4php/src/main/php/LoggerBasicConfigurator.php b/thirdparty/apache-log4php/src/main/php/LoggerBasicConfigurator.php new file mode 100644 index 0000000..359591f --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/LoggerBasicConfigurator.php @@ -0,0 +1,72 @@ +For file based configuration see {@link LoggerPropertyConfigurator}. + *For XML based configuration see {@link LoggerDOMConfigurator}.
+ *
+ * @author Marco Vassura
+ * @version $Revision: 635069 $
+ * @package log4php
+ */
+class LoggerBasicConfigurator implements LoggerConfigurator {
+
+ /**
+ * Add a {@link LoggerAppenderConsole} that uses
+ * the {@link LoggerLayoutTTCC} to the root category.
+ *
+ * @param string $url not used here
+ */
+ public static function configure($url = null)
+ {
+ $root = LoggerManager::getRootLogger();
+ $appender = new LoggerAppenderConsole('A1');
+ $appender->setLayout( new LoggerLayoutTTCC() );
+ $root->addAppender($appender);
+ }
+
+ /**
+ * Reset the default hierarchy to its default.
+ * It is equivalent to
+ *
+ * LoggerManager::resetConfiguration();
+ *
+ *
+ * @see LoggerHierarchy::resetConfiguration()
+ * @static
+ */
+ public static function resetConfiguration()
+ {
+ LoggerManager::resetConfiguration();
+ }
+}
diff --git a/thirdparty/apache-log4php/src/main/php/LoggerDefaultCategoryFactory.php b/thirdparty/apache-log4php/src/main/php/LoggerDefaultCategoryFactory.php
new file mode 100644
index 0000000..36fcf0c
--- /dev/null
+++ b/thirdparty/apache-log4php/src/main/php/LoggerDefaultCategoryFactory.php
@@ -0,0 +1,49 @@
+The casual user does not have to deal with this class directly.
The structure of the logger hierarchy is maintained by the + * getLogger method. The hierarchy is such that children link + * to their parent but parents do not have any pointers to their + * children. Moreover, loggers can be instantiated in any order, in + * particular descendant before ancestor.
+ * + *In case a descendant is created before a particular ancestor, + * then it creates a provision node for the ancestor and adds itself + * to the provision node. Other descendants of the same ancestor add + * themselves to the previously created provision node.
+ * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + */ +class LoggerHierarchy { + + /** + * @var object currently unused + */ + protected $defaultFactory; + + /** + * @var boolean activate internal logging + * @see LoggerLog + */ + public $debug = false; + + /** + * @var array hierarchy tree. saves here all loggers + */ + protected $ht = array(); + + /** + * @var LoggerRoot + */ + protected $root = null; + + /** + * @var LoggerRendererMap + */ + protected $rendererMap; + + /** + * @var LoggerLevel main level threshold + */ + protected $threshold; + + /** + * @var boolean currently unused + */ + protected $emittedNoAppenderWarning = false; + + /** + * @var boolean currently unused + */ + protected $emittedNoResourceBundleWarning = false; + + public static function singleton() + { + static $instance; + + if (!isset($instance)) + $instance = new LoggerHierarchy(new LoggerRoot()); + return $instance; + } + + /** + * Create a new logger hierarchy. + * @param object $root the root logger + */ + protected function __construct($root) + { + $this->root = $root; + // Enable all level levels by default. + $this->setThreshold(LoggerLevel::getLevelAll()); + $this->root->setHierarchy($this); + $this->rendererMap = new LoggerRendererMap(); + $this->defaultFactory = new LoggerDefaultCategoryFactory(); + } + + /** + * Add a HierarchyEventListener event to the repository. + * Not Yet Impl. + */ + public function addHierarchyEventListener($listener) + { + return; + } + + /** + * Add an object renderer for a specific class. + * @param string $classToRender + * @param LoggerObjectRenderer $or + */ + public function addRenderer($classToRender, $or) + { + $this->rendererMap->put($classToRender, $or); + } + + /** + * This call will clear all logger definitions from the internal hashtable. + */ + public function clear() + { + $this->ht = array(); + } + + public function emitNoAppenderWarning($cat) + { + return; + } + + /** + * Check if the named logger exists in the hierarchy. + * @param string $name + * @return boolean + */ + public function exists($name) + { + return isset($this->ht[$name]); + } + + /** + * Not Implemented. + * @param Logger $logger + * @param LoggerAppender $appender + */ + public function fireAddAppenderEvent($logger, $appender) + { + return; + } + + /** + * @deprecated Please use {@link getCurrentLoggers()} instead. + */ + public function getCurrentCategories() + { + return $this->getCurrentLoggers(); + } + + /** + * Returns all the currently defined categories in this hierarchy as an array. + * @return array + */ + public function getCurrentLoggers() + { + return array_values($this->ht); + } + + /** + * Return a new logger instance named as the first parameter using the default factory. + * + * @param string $name logger name + * @param LoggerFactory $factory a {@link LoggerFactory} instance or null + * @return Logger + */ + public function getLogger($name, $factory = null) + { + if ($factory === null) { + return $this->getLoggerByFactory($name, $this->defaultFactory); + } else { + return $this->getLoggerByFactory($name, $factory); + } + } + + /** + * Return a new logger instance named as the first parameter using the default factory. + * + * @param string $name logger name + * @return Logger + * @todo merge with {@link getLogger()} + */ + public function getLoggerByFactory($name, $factory) + { + if (!isset($this->ht[$name])) { + $this->ht[$name] = $factory->makeNewLoggerInstance($name); + $this->ht[$name]->setHierarchy($this); + $nodes = explode('.', $name); + $firstNode = array_shift($nodes); + if ( $firstNode != $name and isset($this->ht[$firstNode])) { + $this->ht[$name]->setParent($this->ht[$firstNode]); + } else { + $this->ht[$name]->setParent($this->root); + } + if (sizeof($nodes) > 0) { + // find parent node + foreach ($nodes as $node) { + $parentNode = "$firstNode.$node"; + if (isset($this->ht[$parentNode]) and $parentNode != $name) { + $this->ht[$name]->setParent($this->ht[$parentNode]); + } + $firstNode .= ".$node"; + } + } + } + return $this->ht[$name]; + } + + /** + * @return LoggerRendererMap Get the renderer map for this hierarchy. + */ + public function getRendererMap() + { + return $this->rendererMap; + } + + /** + * @return LoggerRoot Get the root of this hierarchy. + */ + public function getRootLogger() + { + if (!isset($this->root) or $this->root == null) + $this->root = new LoggerRoot(); + return $this->root; + } + + /** + * @return LoggerLevel Returns the threshold Level. + */ + public function getThreshold() + { + return $this->threshold; + } + + /** + * This method will return true if this repository is disabled + * for level object passed as parameter and false otherwise. + * @return boolean + */ + public function isDisabled($level) + { + return ($this->threshold->level > $level->level); + } + + /** + * @deprecated Deprecated with no replacement. + */ + public function overrideAsNeeded($override) + { + return; + } + + /** + * Reset all values contained in this hierarchy instance to their + * default. + * + * This removes all appenders from all categories, sets + * the level of all non-root categories to null, + * sets their additivity flag to true and sets the level + * of the root logger to {@link LOGGER_LEVEL_DEBUG}. Moreover, + * message disabling is set its default "off" value. + * + *Existing categories are not removed. They are just reset. + * + *
This method should be used sparingly and with care as it will + * block all logging until it is completed.
+ */ + public function resetConfiguration() + { + $root = $this->getRootLogger(); + + $root->setLevel(LoggerLevel::getLevelDebug()); + $this->setThreshold(LoggerLevel::getLevelAll()); + $this->shutDown(); + $loggers = $this->getCurrentLoggers(); + $enumLoggers = sizeof($loggers); + for ($i = 0; $i < $enumLoggers; $i++) { + $loggers[$i]->setLevel(null); + $loggers[$i]->setAdditivity(true); + $loggers[$i]->setResourceBundle(null); + $loggers[$i]->removeAllAppenders(); + } + $this->rendererMap->clear(); + } + + /** + * @deprecated Deprecated with no replacement. + */ + public function setDisableOverride($override) + { + return; + } + + /** + * Used by subclasses to add a renderer to the hierarchy passed as parameter. + * @param string $renderedClass a LoggerRenderer class name + * @param LoggerRenderer $renderer + * + */ + public function setRenderer($renderedClass, $renderer) + { + $this->rendererMap->put($renderedClass, $renderer); + } + + /** + * set a new threshold level + * + * @param LoggerLevel $l + */ + public function setThreshold($l) + { + if ($l !== null) + $this->threshold = $l; + } + + /** + * Shutting down a hierarchy will safely close and remove + * all appenders in all categories including the root logger. + * + *Some appenders such as {@link LoggerSocketAppender} + * need to be closed before the + * application exists. Otherwise, pending logging events might be + * lost. + * + *
The shutdown method is careful to close nested + * appenders before closing regular appenders. This is allows + * configurations where a regular appender is attached to a logger + * and again to a nested appender. + */ + public function shutdown() + { + $this->root->removeAllAppenders(); + $cats = $this->getCurrentLoggers(); + $enumCats = sizeof($cats); + if ($enumCats > 0) { + for ($i = 0; $i < $enumCats; $i++) { + $cats[$i]->removeAllAppenders(); + } + } + } +} diff --git a/thirdparty/apache-log4php/src/main/php/LoggerLayout.php b/thirdparty/apache-log4php/src/main/php/LoggerLayout.php new file mode 100644 index 0000000..6fb7070 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/LoggerLayout.php @@ -0,0 +1,96 @@ +getRenderedMessage(); + } + + /** + * Returns the content type output by this layout. + * @return string + */ + public function getContentType() + { + return "text/plain"; + } + + /** + * Returns the footer for the layout format. + * @return string + */ + public function getFooter() + { + return null; + } + + /** + * Returns the header for the layout format. + * @return string + */ + public function getHeader() + { + return null; + } +} diff --git a/thirdparty/apache-log4php/src/main/php/LoggerLevel.php b/thirdparty/apache-log4php/src/main/php/LoggerLevel.php new file mode 100644 index 0000000..e83b9ca --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/LoggerLevel.php @@ -0,0 +1,266 @@ +OFF, FATAL, ERROR, + * WARN, INFODEBUG and + * ALL. + * + *
The LoggerLevel class may be subclassed to define a larger + * level set.
+ * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @since 0.5 + */ +class LoggerLevel { + + /** + * @var integer + */ + public $level; + + /** + * @var string + */ + public $levelStr; + + /** + * @var integer + */ + public $syslogEquivalent; + + /** + * Constructor + * + * @param integer $level + * @param string $levelStr + * @param integer $syslogEquivalent + */ + public function __construct($level, $levelStr, $syslogEquivalent) + { + $this->level = $level; + $this->levelStr = $levelStr; + $this->syslogEquivalent = $syslogEquivalent; + } + + /** + * Two priorities are equal if their level fields are equal. + * + * @param object $o + * @return boolean + */ + public function equals($o) + { + if ($o instanceof LoggerLevel) { + return ($this->level == $o->level); + } else { + return false; + } + } + + /** + * Returns an Off Level + * @static + * @return LoggerLevel + */ + public static function getLevelOff() + { + static $level; + if (!isset($level)) $level = new LoggerLevel(LOG4PHP_LEVEL_OFF_INT, 'OFF', 0); + return $level; + } + + /** + * Returns a Fatal Level + * @static + * @return LoggerLevel + */ + public static function getLevelFatal() + { + static $level; + if (!isset($level)) $level = new LoggerLevel(LOG4PHP_LEVEL_FATAL_INT, 'FATAL', 0); + return $level; + } + + /** + * Returns an Error Level + * @static + * @return LoggerLevel + */ + public static function getLevelError() + { + static $level; + if (!isset($level)) $level = new LoggerLevel(LOG4PHP_LEVEL_ERROR_INT, 'ERROR', 3); + return $level; + } + + /** + * Returns a Warn Level + * @static + * @return LoggerLevel + */ + public static function getLevelWarn() + { + static $level; + if (!isset($level)) $level = new LoggerLevel(LOG4PHP_LEVEL_WARN_INT, 'WARN', 4); + return $level; + } + + /** + * Returns an Info Level + * @static + * @return LoggerLevel + */ + public static function getLevelInfo() + { + static $level; + if (!isset($level)) $level = new LoggerLevel(LOG4PHP_LEVEL_INFO_INT, 'INFO', 6); + return $level; + } + + /** + * Returns a Debug Level + * @static + * @return LoggerLevel + */ + public static function getLevelDebug() + { + static $level; + if (!isset($level)) $level = new LoggerLevel(LOG4PHP_LEVEL_DEBUG_INT, 'DEBUG', 7); + return $level; + } + + /** + * Returns an All Level + * @static + * @return LoggerLevel + */ + public static function getLevelAll() + { + static $level; + if (!isset($level)) $level = new LoggerLevel(LOG4PHP_LEVEL_ALL_INT, 'ALL', 7); + return $level; + } + + /** + * Return the syslog equivalent of this priority as an integer. + * @final + * @return integer + */ + public function getSyslogEquivalent() + { + return $this->syslogEquivalent; + } + + /** + * Returns true if this level has a higher or equal + * level than the level passed as argument, false + * otherwise. + * + *You should think twice before overriding the default + * implementation of isGreaterOrEqual method. + * + * @param LoggerLevel $r + * @return boolean + */ + public function isGreaterOrEqual($r) + { + return $this->level >= $r->level; + } + + /** + * Returns the string representation of this priority. + * @return string + * @final + */ + public function toString() + { + return $this->levelStr; + } + + /** + * Returns the integer representation of this level. + * @return integer + */ + public function toInt() + { + return $this->level; + } + + /** + * Convert the string passed as argument to a level. If the + * conversion fails, then this method returns a DEBUG Level. + * + * @param mixed $arg + * @param LoggerLevel $default + * @static + */ + public static function toLevel($arg, $defaultLevel = null) + { + if ($defaultLevel === null) { + return self::toLevel($arg, self::getLevelDebug()); + } else { + if (is_int($arg)) { + switch($arg) { + case LOG4PHP_LEVEL_ALL_INT: return self::getLevelAll(); + case LOG4PHP_LEVEL_DEBUG_INT: return self::getLevelDebug(); + case LOG4PHP_LEVEL_INFO_INT: return self::getLevelInfo(); + case LOG4PHP_LEVEL_WARN_INT: return self::getLevelWarn(); + case LOG4PHP_LEVEL_ERROR_INT: return self::getLevelError(); + case LOG4PHP_LEVEL_FATAL_INT: return self::getLevelFatal(); + case LOG4PHP_LEVEL_OFF_INT: return self::getLevelOff(); + default: return $defaultLevel; + } + } else { + switch(strtoupper($arg)) { + case 'ALL': return self::getLevelAll(); + case 'DEBUG': return self::getLevelDebug(); + case 'INFO': return self::getLevelInfo(); + case 'WARN': return self::getLevelWarn(); + case 'ERROR': return self::getLevelError(); + case 'FATAL': return self::getLevelFatal(); + case 'OFF': return self::getLevelOff(); + default: return $defaultLevel; + } + } + } + } +} diff --git a/thirdparty/apache-log4php/src/main/php/LoggerLog.php b/thirdparty/apache-log4php/src/main/php/LoggerLog.php new file mode 100644 index 0000000..60273b6 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/LoggerLog.php @@ -0,0 +1,101 @@ +It uses php {@link PHP_MANUAL#trigger_error trigger_error()} function + * to output messages.
+ *You need to recode methods to output messages in a different way.
+ * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + */ +class LoggerLog { + + protected static $debug = false; + + /** + * Log if debug is enabled. + * + * Log using php {@link PHP_MANUAL#trigger_error trigger_error()} function + * with E_USER_NOTICE level by default. + * + * @param string $message log message + * @param integer $errLevel level to log + * @static + */ + public static function log($message, $errLevel = E_USER_NOTICE) + { + if (LoggerLog::internalDebugging()) + trigger_error($message, $errLevel); + } + + public static function internalDebugging($value = null) + { + if (is_bool($value)) + self::$debug = $value; + return self::$debug; + } + + /** + * Report a debug message. + * + * @param string $message log message + * @static + * @since 0.3 + */ + public static function debug($message) + { + LoggerLog::log($message, E_USER_NOTICE); + } + + /** + * Report an error message. + * + * @param string $message log message + * @static + * @since 0.3 + */ + public static function error($message) + { + trigger_error($message, E_USER_ERROR); + } + + /** + * Report a warning message. + * + * @param string $message log message + * @static + * @since 0.3 + */ + public static function warn($message) + { + trigger_error($message, E_USER_WARNING); + } + +} diff --git a/thirdparty/apache-log4php/src/main/php/LoggerMDC.php b/thirdparty/apache-log4php/src/main/php/LoggerMDC.php new file mode 100644 index 0000000..ccaca4c --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/LoggerMDC.php @@ -0,0 +1,131 @@ +mapped diagnostic contexts. + * + * A Mapped Diagnostic Context, or + * MDC in short, is an instrument for distinguishing interleaved log + * output from different sources. Log output is typically interleaved + * when a server handles multiple clients near-simultaneously. + * + *The MDC is managed on a per thread basis. + * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @since 0.3 + * @package log4php + */ +class LoggerMDC { + + /** + * Put a context value as identified with the key parameter into the current thread's + * context map. + * + *
If the current thread does not have a context map it is + * created as a side effect.
+ * + *Note that you cannot put more than {@link LOGGER_MDC_HT_SIZE} keys.
+ * + * @param string $key the key + * @param string $value the value + * @static + */ + public static function put($key, $value) + { + if ( sizeof($GLOBALS['log4php.LoggerMDC.ht']) < LOGGER_MDC_HT_SIZE ) + $GLOBALS['log4php.LoggerMDC.ht'][$key] = $value; + } + + /** + * Get the context identified by the key parameter. + * + *You can use special key identifiers to map values in + * PHP $_SERVER and $_ENV vars. Just put a 'server.' or 'env.' + * followed by the var name you want to refer.
+ * + *This method has no side effects.
+ * + * @param string $key + * @return string + * @static + */ + public static function get($key) + { + LoggerLog::debug("LoggerMDC::get() key='$key'"); + + if (!empty($key)) { + if (strpos($key, 'server.') === 0) { + $varName = substr($key, 7); + + LoggerLog::debug("LoggerMDC::get() a _SERVER[$varName] is requested."); + + return @$_SERVER[$varName]; + } elseif (strpos($key, 'env.') === 0) { + + $varName = substr($key, 4); + + LoggerLog::debug("LoggerMDC::get() a _ENV[$varName] is requested."); + + return @$_ENV[$varName]; + } elseif (isset($GLOBALS['log4php.LoggerMDC.ht'][$key])) { + + LoggerLog::debug("LoggerMDC::get() a user key is requested."); + + return $GLOBALS['log4php.LoggerMDC.ht'][$key]; + } + } + return ''; + } + + /** + * Remove the the context identified by the key parameter. + * + * It only affects user mappings. + * + * @param string $key + * @return string + * @static + */ + public static function remove($key) + { + unset($GLOBALS['log4php.LoggerMDC.ht'][$key]); + } + +} diff --git a/thirdparty/apache-log4php/src/main/php/LoggerManager.php b/thirdparty/apache-log4php/src/main/php/LoggerManager.php new file mode 100644 index 0000000..c17c8b2 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/LoggerManager.php @@ -0,0 +1,258 @@ +exists($name); + } + + /** + * Returns an array this whole Logger instances. + * + * @static + * @see Logger + * @return array + */ + public static function getCurrentLoggers() + { + return self::getLoggerRepository()->getCurrentLoggers(); + } + + /** + * Returns the root logger. + * + * @static + * @return object + * @see LoggerRoot + */ + public static function getRootLogger() + { + return self::getLoggerRepository()->getRootLogger(); + } + + /** + * Returns the specified Logger. + * + * @param string $name logger name + * @param LoggerFactory $factory a {@link LoggerFactory} instance or null + * @static + * @return Logger + */ + public static function getLogger($name, $factory = null) + { + return self::getLoggerRepository()->getLogger($name, $factory); + } + + /** + * Returns the LoggerHierarchy. + * + * @static + * @return LoggerHierarchy + */ + public static function getLoggerRepository() + { + return LoggerHierarchy::singleton(); + } + + + /** + * Destroy loggers object tree. + * + * @static + * @return boolean + */ + public static function resetConfiguration() + { + return self::getLoggerRepository()->resetConfiguration(); + } + + /** + * Does nothing. + * @static + */ + public static function setRepositorySelector($selector, $guard) + { + return; + } + + /** + * Safely close all appenders. + * @static + */ + public static function shutdown() + { + return self::getLoggerRepository()->shutdown(); + } +} + +// --------------------------------------------------------------------------- +// --------------------------------------------------------------------------- +// --------------------------------------------------------------------------- + +if (!defined('LOG4PHP_DEFAULT_INIT_OVERRIDE')) { + if (isset($_ENV['log4php.defaultInitOverride'])) { + /** + * @ignore + */ + define('LOG4PHP_DEFAULT_INIT_OVERRIDE', + LoggerOptionConverter::toBoolean($_ENV['log4php.defaultInitOverride'], false) + ); + } elseif (isset($GLOBALS['log4php.defaultInitOverride'])) { + /** + * @ignore + */ + define('LOG4PHP_DEFAULT_INIT_OVERRIDE', + LoggerOptionConverter::toBoolean($GLOBALS['log4php.defaultInitOverride'], false) + ); + } else { + /** + * Controls init execution + * + * With this constant users can skip the default init procedure that is + * called when this file is included. + * + *If it is not user defined, log4php tries to autoconfigure using (in order):
+ * + * - the$_ENV['log4php.defaultInitOverride'] variable.
+ * - the $GLOBALS['log4php.defaultInitOverride'] global variable.
+ * - defaults to false
+ *
+ * @var boolean
+ */
+ define('LOG4PHP_DEFAULT_INIT_OVERRIDE', false);
+ }
+}
+
+if (!defined('LOG4PHP_CONFIGURATION')) {
+ if (isset($_ENV['log4php.configuration'])) {
+ /**
+ * @ignore
+ */
+ define('LOG4PHP_CONFIGURATION', trim($_ENV['log4php.configuration']));
+ } else {
+ /**
+ * Configuration file.
+ *
+ * This constant tells configurator classes where the configuration + * file is located.
+ *If not set by user, log4php tries to set it automatically using + * (in order):
+ * + * - the$_ENV['log4php.configuration'] enviroment variable.
+ * - defaults to 'log4php.properties'.
+ *
+ * @var string
+ */
+ define('LOG4PHP_CONFIGURATION', 'log4php.properties');
+ }
+}
+
+if (!defined('LOG4PHP_CONFIGURATOR_CLASS')) {
+ if ( strtolower(substr( LOG4PHP_CONFIGURATION, -4 )) == '.xml') {
+ /**
+ * @ignore
+ */
+ define('LOG4PHP_CONFIGURATOR_CLASS', LOG4PHP_DIR . '/xml/LoggerDOMConfigurator');
+ } else {
+ /**
+ * Holds the configurator class name.
+ *
+ * This constant is set with the fullname (path included but non the + * .php extension) of the configurator class that init procedure will use.
+ *If not set by user, log4php tries to set it automatically.
+ *If {@link LOG4PHP_CONFIGURATION} has '.xml' extension set the + * constants to '{@link LOG4PHP_DIR}/xml/{@link LoggerDOMConfigurator}'.
+ *Otherwise set the constants to + * '{@link LOG4PHP_DIR}/{@link LoggerPropertyConfigurator}'.
+ * + *Security Note: classfile pointed by this constant will be brutally
+ * included with a:
+ * @include_once(LOG4PHP_CONFIGURATOR_CLASS . ".php");
This procedure tries to configure the {@link LoggerHierarchy} using the + * configurator class defined via {@link LOG4PHP_CONFIGURATOR_CLASS} that tries + * to load the configurator file defined in {@link LOG4PHP_CONFIGURATION}. + * If something goes wrong a warn is raised.
+ *Users can skip this procedure using {@link LOG4PHP_DEFAULT_INIT_OVERRIDE} + * constant.
+ * + * @return boolean + */ +function LoggerManagerDefaultInit() +{ + $configuratorClass = basename(LOG4PHP_CONFIGURATOR_CLASS); + if (!class_exists($configuratorClass)) { + include_once(LOG4PHP_CONFIGURATOR_CLASS . ".php"); + } + if (class_exists($configuratorClass)) { + + return call_user_func(array($configuratorClass, 'configure'), LOG4PHP_CONFIGURATION); + + } else { + LoggerLog::warn("LoggerManagerDefaultInit() Configurator '{$configuratorClass}' doesnt exists"); + return false; + } +} + diff --git a/thirdparty/apache-log4php/src/main/php/LoggerNDC.php b/thirdparty/apache-log4php/src/main/php/LoggerNDC.php new file mode 100644 index 0000000..3b76a37 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/LoggerNDC.php @@ -0,0 +1,242 @@ +nested diagnostic contexts as + * defined by Neil Harrison in the article "Patterns for Logging + * Diagnostic Messages" part of the book "Pattern Languages of + * Program Design 3" edited by Martin et al. + * + *A Nested Diagnostic Context, or NDC in short, is an instrument + * to distinguish interleaved log output from different sources. Log + * output is typically interleaved when a server handles multiple + * clients near-simultaneously. + * + *
Interleaved log output can still be meaningful if each log entry + * from different contexts had a distinctive stamp. This is where NDCs + * come into play. + * + *
Note that NDCs are managed on a per thread + * basis. NDC operations such as {@link push()}, {@link pop()}, + * {@link clear()}, {@link getDepth()} and {@link setMaxDepth()} + * affect the NDC of the current thread only. NDCs of other + * threads remain unaffected. + * + *
For example, a servlet can build a per client request NDC + * consisting the clients host name and other information contained in + * the the request. Cookies are another source of distinctive + * information. To build an NDC one uses the {@link push()} + * operation.
+ * + * Simply put, + * + * - Contexts can be nested. + * - When entering a context, call + *LoggerNDC::push()
+ * As a side effect, if there is no nested diagnostic context for the
+ * current thread, this method will create it.
+ * - When leaving a context, call
+ * LoggerNDC::pop()
+ * - When exiting a thread make sure to call {@link remove()}
+ *
+ * There is no penalty for forgetting to match each
+ * push operation with a corresponding pop,
+ * except the obvious mismatch between the real application context
+ * and the context set in the NDC.
If configured to do so, {@link LoggerPatternLayout} and {@link LoggerLayoutTTCC} + * instances automatically retrieve the nested diagnostic + * context for the current thread without any user intervention. + * Hence, even if a servlet is serving multiple clients + * simultaneously, the logs emanating from the same code (belonging to + * the same category) can still be distinguished because each client + * request will have a different NDC tag.
+ * + * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @since 0.3 + */ +class LoggerNDC { + + /** + * Clear any nested diagnostic information if any. This method is + * useful in cases where the same thread can be potentially used + * over and over in different unrelated contexts. + * + *This method is equivalent to calling the {@link setMaxDepth()} + * method with a zero maxDepth argument. + * + * @static + */ + public static function clear() + { + LoggerLog::debug("LoggerNDC::clear()"); + + $GLOBALS['log4php.LoggerNDC.ht'] = array(); + } + + /** + * Never use this method directly, use the {@link LoggerLoggingEvent::getNDC()} method instead. + * @static + * @return array + */ + public static function get() + { + LoggerLog::debug("LoggerNDC::get()"); + + return $GLOBALS['log4php.LoggerNDC.ht']; + } + + /** + * Get the current nesting depth of this diagnostic context. + * + * @see setMaxDepth() + * @return integer + * @static + */ + public static function getDepth() + { + LoggerLog::debug("LoggerNDC::getDepth()"); + + return sizeof($GLOBALS['log4php.LoggerNDC.ht']); + } + + /** + * Clients should call this method before leaving a diagnostic + * context. + * + *
The returned value is the value that was pushed last. If no + * context is available, then the empty string "" is returned.
+ * + * @return string The innermost diagnostic context. + * @static + */ + public static function pop() + { + LoggerLog::debug("LoggerNDC::pop()"); + + if (sizeof($GLOBALS['log4php.LoggerNDC.ht']) > 0) { + return array_pop($GLOBALS['log4php.LoggerNDC.ht']); + } else { + return ''; + } + } + + /** + * Looks at the last diagnostic context at the top of this NDC + * without removing it. + * + *The returned value is the value that was pushed last. If no + * context is available, then the empty string "" is returned.
+ * @return string The innermost diagnostic context. + * @static + */ + public static function peek() + { + LoggerLog::debug("LoggerNDC::peek()"); + + if (sizeof($GLOBALS['log4php.LoggerNDC.ht']) > 0) { + return end($GLOBALS['log4php.LoggerNDC.ht']); + } else { + return ''; + } + } + + /** + * Push new diagnostic context information for the current thread. + * + *The contents of the message parameter is + * determined solely by the client. + * + * @param string $message The new diagnostic context information. + * @static + */ + public static function push($message) + { + LoggerLog::debug("LoggerNDC::push()"); + + array_push($GLOBALS['log4php.LoggerNDC.ht'], (string)$message); + } + + /** + * Remove the diagnostic context for this thread. + * @static + */ + public static function remove() + { + LoggerLog::debug("LoggerNDC::remove()"); + + LoggerNDC::clear(); + } + + /** + * Set maximum depth of this diagnostic context. If the current + * depth is smaller or equal to maxDepth, then no + * action is taken. + * + *
This method is a convenient alternative to multiple + * {@link pop()} calls. Moreover, it is often the case that at + * the end of complex call sequences, the depth of the NDC is + * unpredictable. The {@link setMaxDepth()} method circumvents + * this problem. + * + * @param integer $maxDepth + * @see getDepth() + * @static + */ + public static function setMaxDepth($maxDepth) + { + LoggerLog::debug("LoggerNDC::setMaxDepth() maxDepth='$maxDepth'"); + + $maxDepth = (int)$maxDepth; + if ($maxDepth <= LOGGER_NDC_HT_SIZE) { + if (LoggerNDC::getDepth() > $maxDepth) { + $GLOBALS['log4php.LoggerNDC.ht'] = array_slice($GLOBALS['log4php.LoggerNDC.ht'], $maxDepth); + } + $GLOBALS['log4php.LoggerNDC.maxDepth'] = $maxDepth; + } + } + +} diff --git a/thirdparty/apache-log4php/src/main/php/LoggerPropertyConfigurator.php b/thirdparty/apache-log4php/src/main/php/LoggerPropertyConfigurator.php new file mode 100644 index 0000000..011f23b --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/LoggerPropertyConfigurator.php @@ -0,0 +1,673 @@ +It is sometimes useful to see how log4php is reading configuration + * files. You can enable log4php internal logging by defining the + * log4php.debug variable.
+ * + *The LoggerPropertyConfigurator does not handle the + * advanced configuration features supported by the {@link LoggerDOMConfigurator} + * such as support for {@link LoggerFilter}, + custom {@link LoggerErrorHandlers}, nested appenders such as the + {@link Logger AsyncAppender}, + * etc. + * + *
All option values admit variable substitution. The + * syntax of variable substitution is similar to that of Unix + * shells. The string between an opening "${" and + * closing "}" is interpreted as a key. The value of + * the substituted variable can be defined as a system property or in + * the configuration file itself. The value of the key is first + * searched in the defined constants, in the enviroments variables + * and if not found there, it is + * then searched in the configuration file being parsed. The + * corresponding value replaces the ${variableName} sequence.
+ *For example, if $_ENV['home'] env var is set to + * /home/xyz, then every occurrence of the sequence + * ${home} will be interpreted as + * /home/xyz. See {@link LoggerOptionConverter::getSystemProperty()} + * for details.
+ * + *Please note that boolean values should be quoted otherwise the default
+ * value will be chosen. E.g.:
+ *
+ * // Does *not* work. Will always result in default value
+ * // (which is currently 'true' for this attribute).
+ * log4php.appender.A2.append=false
+ * // Does work.
+ * log4php.appender.A2.append="false"
+ *
+ *
The function {@link PHP_MANUAL#parse_ini_file} is used to read the + * file.
+ * + * The existing configuration is not cleared nor reset. + * If you require a different behavior, then call + * {@link LoggerManager::resetConfiguration()} + * method before calling {@link doConfigure()}. + * + *The configuration file consists of statements in the format + * key=value. The syntax of different configuration + * elements are discussed below. + * + *
Repository-wide threshold
+ * + *The repository-wide threshold filters logging requests by level + * regardless of logger. The syntax is: + * + *
+ * log4php.threshold=[level] + *+ * + *
The level value can consist of the string values OFF, FATAL, + * ERROR, WARN, INFO, DEBUG, ALL or a custom level value. A + * custom level value can be specified in the form + * level#classname. By default the repository-wide threshold is set + * to the lowest possible value, namely the level ALL. + *
+ * + * + *Appender configuration
+ * + *Appender configuration syntax is:
+ *+ * ; For appender named appenderName, set its class. + * ; Note: The appender name can contain dots. + * log4php.appender.appenderName=name_of_appender_class + * + * ; Set appender specific options. + * + * log4php.appender.appenderName.option1=value1 + * log4php.appender.appenderName.optionN=valueN + *+ * + * For each named appender you can configure its {@link LoggerLayout}. The + * syntax for configuring an appender's layout is: + *
+ * log4php.appender.appenderName.layout=name_of_layout_class + * log4php.appender.appenderName.layout.option1=value1 + * .... + * log4php.appender.appenderName.layout.optionN=valueN + *+ * + *
Configuring loggers
+ * + *The syntax for configuring the root logger is: + *
+ * log4php.rootLogger=[level], appenderName, appenderName, ... + *+ * + *
This syntax means that an optional level can be + * supplied followed by appender names separated by commas. + * + *
The level value can consist of the string values OFF, FATAL, + * ERROR, WARN, INFO, DEBUG, ALL or a custom level value. A + * custom level value can be specified in the form
+ * + *level#classname+ * + *
If a level value is specified, then the root level is set + * to the corresponding level. If no level value is specified, + * then the root level remains untouched. + * + *
The root logger can be assigned multiple appenders. + * + *
Each appenderName (separated by commas) will be added to + * the root logger. The named appender is defined using the + * appender syntax defined above. + * + *
For non-root categories the syntax is almost the same: + *
+ * log4php.logger.logger_name=[level|INHERITED|NULL], appenderName, appenderName, ... + *+ * + *
The meaning of the optional level value is discussed above + * in relation to the root logger. In addition however, the value + * INHERITED can be specified meaning that the named logger should + * inherit its level from the logger hierarchy.
+ * + *If no level value is supplied, then the level of the + * named logger remains untouched.
+ * + *By default categories inherit their level from the + * hierarchy. However, if you set the level of a logger and later + * decide that that logger should inherit its level, then you should + * specify INHERITED as the value for the level value. NULL is a + * synonym for INHERITED.
+ * + *Similar to the root logger syntax, each appenderName + * (separated by commas) will be attached to the named logger.
+ * + *See the appender additivity rule in the user manual for + * the meaning of the additivity flag. + * + *
ObjectRenderers
+ * + *You can customize the way message objects of a given type are + * converted to String before being logged. This is done by + * specifying a {@link LoggerObjectRenderer} + * for the object type would like to customize.
+ * + *The syntax is: + * + *
+ * log4php.renderer.name_of_rendered_class=name_of_rendering.class + *+ * + * As in, + *
+ * log4php.renderer.myFruit=myFruitRenderer + *+ * + *
Logger Factories
+ * + * The usage of custom logger factories is discouraged and no longer + * documented. + * + *Example
+ * + *An example configuration is given below. Other configuration + * file examples are given in the tests folder. + * + *
+ * ; Set options for appender named "A1".
+ * ; Appender "A1" will be a LoggerAppenderSyslog
+ * log4php.appender.A1=LoggerAppenderSyslog
+ *
+ * ; The syslog daemon resides on www.abc.net
+ * log4php.appender.A1.ident=log4php-test
+ *
+ * ; A1's layout is a LoggerPatternLayout, using the conversion pattern
+ * ; %r %-5p %c{2} %M.%L %x - %m%n. Thus, the log output will
+ * ; include the relative time since the start of the application in
+ * ; milliseconds, followed by the level of the log request,
+ * ; followed by the two rightmost components of the logger name,
+ * ; followed by the callers method name, followed by the line number,
+ * ; the nested disgnostic context and finally the message itself.
+ * ; Refer to the documentation of LoggerPatternLayout} for further information
+ * ; on the syntax of the ConversionPattern key.
+ * log4php.appender.A1.layout=LoggerPatternLayout
+ * log4php.appender.A1.layout.ConversionPattern="%-4r %-5p %c{2} %M.%L %x - %m%n"
+ *
+ * ; Set options for appender named "A2"
+ * ; A2 should be a LoggerAppenderRollingFile, with maximum file size of 10 MB
+ * ; using at most one backup file. A2's layout is TTCC, using the
+ * ; ISO8061 date format with context printing enabled.
+ * log4php.appender.A2=LoggerAppenderRollingFile
+ * log4php.appender.A2.MaxFileSize=10MB
+ * log4php.appender.A2.MaxBackupIndex=1
+ * log4php.appender.A2.layout=LoggerLayoutTTCC
+ * log4php.appender.A2.layout.ContextPrinting="true"
+ * log4php.appender.A2.layout.DateFormat="%c"
+ *
+ * ; Root logger set to DEBUG using the A2 appender defined above.
+ * log4php.rootLogger=DEBUG, A2
+ *
+ * ; Logger definitions:
+ * ; The SECURITY logger inherits is level from root. However, it's output
+ * ; will go to A1 appender defined above. It's additivity is non-cumulative.
+ * log4php.logger.SECURITY=INHERIT, A1
+ * log4php.additivity.SECURITY=false
+ *
+ * ; Only warnings or above will be logged for the logger "SECURITY.access".
+ * ; Output will go to A1.
+ * log4php.logger.SECURITY.access=WARN
+ *
+ *
+ * ; The logger "class.of.the.day" inherits its level from the
+ * ; logger hierarchy. Output will go to the appender's of the root
+ * ; logger, A2 in this case.
+ * log4php.logger.class.of.the.day=INHERIT
+ *
+ *
+ * Refer to the setOption method in each Appender and + * Layout for class specific options.
+ * + *Use the ";" character at the + * beginning of a line for comments.
+ * + * @param string $url The name of the configuration file where the + * configuration information is stored. + * @param LoggerHierarchy &$repository the repository to apply the configuration + */ + function doConfigure($url, &$repository) + { + $properties = @parse_ini_file($url); + if ($properties === false) { + LoggerLog::warn("LoggerPropertyConfigurator::doConfigure() cannot load '$url' configuration."); + return false; + } + return $this->doConfigureProperties($properties, $repository); + } + + + /** + * Read configuration options from properties. + * + * @see doConfigure(). + * @param array $properties + * @param LoggerHierarchy &$hierarchy + */ + function doConfigureProperties($properties, &$hierarchy) + { + $value = null; + + if (isset($properties[LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_LOGGER_DEBUG_KEY])) + { + $value = @$properties[LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_LOGGER_DEBUG_KEY]; + } + + if (!empty($value)) { + LoggerLog::internalDebugging(LoggerOptionConverter::toBoolean($value, LoggerLog::internalDebugging())); + } + + $thresholdStr = ''; + if (isset($properties[LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_THRESHOLD_PREFIX])) + { + $thresholdStr = @$properties[LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_THRESHOLD_PREFIX]; + } + $hierarchy->setThreshold(LoggerOptionConverter::toLevel($thresholdStr, LoggerLevel::getLevelAll())); + + $this->configureRootCategory($properties, $hierarchy); + $this->configureLoggerFactory($properties); + $this->parseCatsAndRenderers($properties, $hierarchy); + + LoggerLog::debug("LoggerPropertyConfigurator::doConfigureProperties() Finished configuring."); + + return true; + } + + // -------------------------------------------------------------------------- + // Internal stuff + // -------------------------------------------------------------------------- + + /** + * Check the provided Properties object for a + * {@link LoggerFactory} entry specified by + * {@link LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_LOGGER_FACTORY_KEY}. + * + * If such an entry exists, an attempt is made to create an instance using + * the default constructor. + * This instance is used for subsequent Category creations + * within this configurator. + * + * @see parseCatsAndRenderers() + * @param array $props array of properties + */ + function configureLoggerFactory($props) + { + $factoryFqcn = null; + if (isset($props[LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_LOGGER_FACTORY_KEY])) + { + $factoryFqcn = @$props[LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_LOGGER_FACTORY_KEY]; + } + if(!empty($factoryFqcn)) { + $factoryClassName = basename($factoryFqcn); + LoggerLog::debug( + "LoggerPropertyConfigurator::configureLoggerFactory() Trying to load factory [" . + $factoryClassName . + "]." + ); + + if (!class_exists($factoryClassName)) + @include_once("{$factoryFqcn}.php"); + if (class_exists($factoryClassName)) { + $loggerFactory = new $factoryClassName(); + } else { + LoggerLog::debug( + "LoggerPropertyConfigurator::configureLoggerFactory() Unable to load factory [" . + $factoryClassName . + "]. Using default." + ); + $loggerFactory = $this->loggerFactory; + } + + LoggerLog::debug( + "LoggerPropertyConfigurator::configureLoggerFactory() ". + "Setting properties for category factory [" . get_class($loggerFactory) . "]." + ); + + LoggerPropertySetter::setPropertiesByObject($loggerFactory, $props, LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_FACTORY_PREFIX . "."); + } + } + + /** + * @param array $props array of properties + * @param LoggerHierarchy &$hierarchy + */ + function configureRootCategory($props, &$hierarchy) + { + $effectivePrefix = LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_ROOT_LOGGER_PREFIX; + $value = @$props[LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_ROOT_LOGGER_PREFIX]; + + if(empty($value)) { + $value = @$props[LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_ROOT_CATEGORY_PREFIX]; + $effectivePrefix = LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_ROOT_CATEGORY_PREFIX; + } + + if (empty($value)) { + LoggerLog::debug( + "LoggerPropertyConfigurator::configureRootCategory() ". + "Could not find root logger information. Is this OK?" + ); + } else { + $root = $hierarchy->getRootLogger(); + // synchronized(root) { + $this->parseCategory( + $props, + $root, + $effectivePrefix, + LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_INTERNAL_ROOT_NAME, + $value + ); + // } + } + } + + /** + * Parse non-root elements, such non-root categories and renderers. + * + * @param array $props array of properties + * @param LoggerHierarchy &$hierarchy + */ + function parseCatsAndRenderers($props, &$hierarchy) + { + while(list($key,$value) = each($props)) { + if( strpos($key, LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_CATEGORY_PREFIX) === 0 or + strpos($key, LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_LOGGER_PREFIX) === 0) { + if(strpos($key, LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_CATEGORY_PREFIX) === 0) { + $loggerName = substr($key, strlen(LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_CATEGORY_PREFIX)); + } elseif (strpos($key, LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_LOGGER_PREFIX) === 0) { + $loggerName = substr($key, strlen(LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_LOGGER_PREFIX)); + } + $logger =& $hierarchy->getLogger($loggerName, $this->loggerFactory); + // synchronized(logger) { + $this->parseCategory($props, $logger, $key, $loggerName, $value); + $this->parseAdditivityForLogger($props, $logger, $loggerName); + // } + } elseif (strpos($key, LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_RENDERER_PREFIX) === 0) { + $renderedClass = substr($key, strlen(LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_RENDERER_PREFIX)); + $renderingClass = $value; + if (method_exists($hierarchy, 'addrenderer')) { // ? + LoggerRendererMap::addRenderer($hierarchy, $renderedClass, $renderingClass); + } + } + } + } + + /** + * Parse the additivity option for a non-root category. + * + * @param array $props array of properties + * @param Logger &$cat + * @param string $loggerName + */ + function parseAdditivityForLogger($props, &$cat, $loggerName) + { + $value = LoggerOptionConverter::findAndSubst( + LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_ADDITIVITY_PREFIX . $loggerName, + $props + ); + LoggerLog::debug( + "LoggerPropertyConfigurator::parseAdditivityForLogger() ". + "Handling " . LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_ADDITIVITY_PREFIX . $loggerName . "=[{$value}]" + ); + // touch additivity only if necessary + if(!empty($value)) { + $additivity = LoggerOptionConverter::toBoolean($value, true); + LoggerLog::debug( + "LoggerPropertyConfigurator::parseAdditivityForLogger() ". + "Setting additivity for [{$loggerName}] to [{$additivity}]" + ); + $cat->setAdditivity($additivity); + } + } + + /** + * This method must work for the root category as well. + * + * @param array $props array of properties + * @param Logger &$logger + * @param string $optionKey + * @param string $loggerName + * @param string $value + * @return Logger + */ + public function parseCategory($props, &$logger, $optionKey, $loggerName, $value) { + LoggerLog::debug( + "LoggerPropertyConfigurator::parseCategory() ". + "Parsing for [{$loggerName}] with value=[{$value}]." + ); + + // We must skip over ',' but not white space + $st = explode(',', $value); + + // If value is not in the form ", appender.." or "", then we should set + // the level of the loggeregory. + + if(!(empty($value) || @$value[0] == ',')) { + // just to be on the safe side... + if(sizeof($st) == 0) + return; + + $levelStr = current($st); + LoggerLog::debug( + "LoggerPropertyConfigurator::parseCategory() ". + "Level token is [$levelStr]." + ); + + // If the level value is inherited, set category level value to + // null. We also check that the user has not specified inherited for the + // root category. + if('INHERITED' == strtoupper($levelStr) || 'NULL' == strtoupper($levelStr)) { + if ($loggerName == LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_INTERNAL_ROOT_NAME) { + LoggerLog::warn( + "LoggerPropertyConfigurator::parseCategory() ". + "The root logger cannot be set to null." + ); + } else { + $logger->setLevel(null); + } + } else { + $logger->setLevel(LoggerOptionConverter::toLevel($levelStr, LoggerLevel::getLevelDebug())); + } + } + + // Begin by removing all existing appenders. + $logger->removeAllAppenders(); + while($appenderName = next($st)) { + $appenderName = trim($appenderName); + if(empty($appenderName)) + continue; + LoggerLog::debug( + "LoggerPropertyConfigurator::parseCategory() ". + "Parsing appender named [{$appenderName}]." + ); + $appender = $this->parseAppender($props, $appenderName); + if($appender !== null) { + $logger->addAppender($appender); + } + } + } + + /** + * @param array $props array of properties + * @param string $appenderName + * @return LoggerAppender + */ + function parseAppender($props, $appenderName) + { + $appender = LoggerAppender::singleton($appenderName); + if($appender !== null) { + LoggerLog::debug( + "LoggerPropertyConfigurator::parseAppender() ". + "Appender [{$appenderName}] was already parsed." + ); + return $appender; + } + // Appender was not previously initialized. + $prefix = LOG4PHP_LOGGER_PROPERTY_CONFIGURATOR_APPENDER_PREFIX . $appenderName; + $layoutPrefix = $prefix . ".layout"; + $appenderClass = @$props[$prefix]; + if (!empty($appenderClass)) { + $appender = LoggerAppender::singleton($appenderName, $appenderClass); + if($appender === null) { + LoggerLog::warn( + "LoggerPropertyConfigurator::parseAppender() ". + "Could not instantiate appender named [$appenderName]." + ); + return null; + } + } else { + LoggerLog::warn( + "LoggerPropertyConfigurator::parseAppender() ". + "Could not instantiate appender named [$appenderName] with null className." + ); + return null; + } + + $appender->setName($appenderName); + if( $appender->requiresLayout() ) { + LoggerLog::debug( + "LoggerPropertyConfigurator::parseAppender() ". + "Parsing layout section for [$appenderName]." + ); + $layoutClass = @$props[$layoutPrefix]; + $layoutClass = LoggerOptionConverter::substVars($layoutClass, $props); + if (empty($layoutClass)) { + LoggerLog::warn( + "LoggerPropertyConfigurator::parseAppender() ". + "layout class is empty in '$layoutPrefix'. Using Simple layout" + ); + $layout = LoggerLayout::factory('LoggerLayoutSimple'); + } else { + $layout = LoggerLayout::factory($layoutClass); + + if($layout === null) { + LoggerLog::warn( + "LoggerPropertyConfigurator::parseAppender() ". + "cannot create layout '$layoutClass'. Using Simple layout" + ); + $layout = LoggerLayout::factory('LoggerLayoutSimple'); + } + } + + LoggerLog::debug( + "LoggerPropertyConfigurator::parseAppender() ". + "Parsing layout options for [$appenderName]." + ); + LoggerPropertySetter::setPropertiesByObject($layout, $props, $layoutPrefix . "."); + LoggerLog::debug( + "LoggerPropertyConfigurator::parseAppender() ". + "End Parsing layout options for [$appenderName]." + ); + $appender->setLayout($layout); + + } + LoggerPropertySetter::setPropertiesByObject($appender, $props, $prefix . "."); + LoggerLog::debug( + "LoggerPropertyConfigurator::parseAppender() ". + "Parsed [{$appenderName}] options." + ); + return $appender; + } + +} diff --git a/thirdparty/apache-log4php/src/main/php/LoggerRoot.php b/thirdparty/apache-log4php/src/main/php/LoggerRoot.php new file mode 100644 index 0000000..16b70ec --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/LoggerRoot.php @@ -0,0 +1,105 @@ +name); + if ($level == null) + $level = LoggerLevel::getLevelAll(); + $this->setLevel($level); + } + + /** + * @return LoggerLevel the level + */ + public function getChainedLevel() + { + return $this->level; + } + + /** + * Setting a null value to the level of the root category may have catastrophic results. + * @param LoggerLevel $level + */ + public function setLevel($level) + { + if ($level != null) { + $this->level = $level; + } + } + + /** + * Please use setLevel() instead. + * @param LoggerLevel $level + * @deprecated + */ + public function setPriority($level) + { + $this->setLevel($level); + } + + /** + * Always returns false. + * Because LoggerRoot has no parents, it returns false. + * @param Logger $parent + * @return boolean + */ + public function setParent($parent) + { + return false; + } +} diff --git a/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderAdodb.php b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderAdodb.php new file mode 100644 index 0000000..531fade --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderAdodb.php @@ -0,0 +1,281 @@ +This appender uses a table in a database to log events. + *Parameters are {@link $host}, {@link $user}, {@link $password}, + * {@link $database}, {@link $createTable}, {@link $table} and {@link $sql}.
+ *See examples in test directory.
+ * + * @author sbwNote: Use this Appender with command-line php scripts. + * On web scripts this appender has no effects.
+ *This appender requires a layout.
+ * + * @author Marco Vassura + * @author Knut UrdalenParameters are {@link $dsn}, {@link $createTable}, {@link table} and {@link $sql}.
+ *See examples in test directory.
+ * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage appenders + * @since 0.3 + */ +class LoggerAppenderDb extends LoggerAppenderSkeleton { + + /** + * Create the log table if it does not exists (optional). + * @var boolean + */ + var $createTable = true; + + /** + * PEAR::Db Data source name. Read PEAR::Db for dsn syntax (mandatory). + * @var string + */ + var $dsn; + + /** + * A {@link LoggerPatternLayout} string used to format a valid insert query (mandatory). + * @var string + */ + var $sql; + + /** + * Table name to write events. Used only if {@link $createTable} is true. + * @var string + */ + var $table; + + /** + * @var object PEAR::Db instance + * @access private + */ + var $db = null; + + /** + * @var boolean used to check if all conditions to append are true + * @access private + */ + var $canAppend = true; + + /** + * @access private + */ + var $requiresLayout = false; + + /** + * Constructor. + * + * @param string $name appender name + */ + function LoggerAppenderDb($name) + { + $this->LoggerAppenderSkeleton($name); + } + + /** + * Setup db connection. + * Based on defined options, this method connects to db defined in {@link $dsn} + * and creates a {@link $table} table if {@link $createTable} is true. + * @return boolean true if all ok. + */ + function activateOptions() + { + $this->db = DB::connect($this->dsn); + + if (DB::isError($this->db)) { + LoggerLog::debug("LoggerAppenderDb::activateOptions() DB Connect Error [".$this->db->getMessage()."]"); + $this->db = null; + $this->closed = true; + $this->canAppend = false; + + } else { + + $this->layout = LoggerLayout::factory('LoggerPatternLayout'); + $this->layout->setConversionPattern($this->getSql()); + + // test if log table exists + $tableInfo = $this->db->tableInfo($this->table, $mode = null); + if (DB::isError($tableInfo) and $this->getCreateTable()) { + $query = "CREATE TABLE {$this->table} (timestamp varchar(32),logger varchar(32),level varchar(32),message varchar(64),thread varchar(32),file varchar(64),line varchar(4) );"; + + LoggerLog::debug("LoggerAppenderDb::activateOptions() creating table '{$this->table}'... using sql='$query'"); + + $result = $this->db->query($query); + if (DB::isError($result)) { + LoggerLog::debug("LoggerAppenderDb::activateOptions() error while creating '{$this->table}'. Error is ".$result->getMessage()); + $this->closed = true; + $this->canAppend = false; + return; + } + } + $this->canAppend = true; + $this->closed = false; + } + + } + + function append($event) + { + if ($this->canAppend) { + + $query = $this->layout->format($event); + + LoggerLog::debug("LoggerAppenderDb::append() query='$query'"); + + $this->db->query($query); + } + } + + function close() + { + if ($this->db !== null) + $this->db->disconnect(); + $this->closed = true; + } + + /** + * @return boolean + */ + function getCreateTable() + { + return $this->createTable; + } + + /** + * @return string the defined dsn + */ + function getDsn() + { + return $this->dsn; + } + + /** + * @return string the sql pattern string + */ + function getSql() + { + return $this->sql; + } + + /** + * @return string the table name to create + */ + function getTable() + { + return $this->table; + } + + function setCreateTable($flag) + { + $this->createTable = LoggerOptionConverter::toBoolean($flag, true); + } + + function setDsn($newDsn) + { + $this->dsn = $newDsn; + } + + function setSql($sql) + { + $this->sql = $sql; + } + + function setTable($table) + { + $this->table = $table; + } + +} + diff --git a/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderEcho.php b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderEcho.php new file mode 100644 index 0000000..3819c21 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderEcho.php @@ -0,0 +1,82 @@ +This appender requires a layout. + * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage appenders + */ +class LoggerAppenderEcho extends LoggerAppenderSkeleton { + + /** + * @access private + */ + var $requiresLayout = true; + + /** + * @var boolean used internally to mark first append + * @access private + */ + var $firstAppend = true; + + function activateOptions() + { + $this->closed = false; + return; + } + + function close() + { + if (!$this->firstAppend) + echo $this->layout->getFooter(); + $this->closed = true; + } + + function append($event) + { + LoggerLog::debug("LoggerAppenderEcho::append()"); + + if ($this->layout !== null) { + if ($this->firstAppend) { + echo $this->layout->getHeader(); + $this->firstAppend = false; + } + echo $this->layout->format($event); + } + } +} + diff --git a/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderFile.php b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderFile.php new file mode 100644 index 0000000..7df66aa --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderFile.php @@ -0,0 +1,158 @@ +file), + * {@link $append}. + * + * @author Marco Vassura + * @author Knut UrdalenThis appender requires a layout.
+ * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage appenders + */ +class LoggerAppenderMail extends LoggerAppenderSkeleton { + + /** + * @var string 'from' field + */ + var $from = null; + + /** + * @var string 'subject' field + */ + var $subject = 'Log4php Report'; + + /** + * @var string 'to' field + */ + var $to = null; + + /** + * @var string used to create mail body + * @access private + */ + var $body = ''; + + /** + * Constructor. + * + * @param string $name appender name + */ + public function __construct($name) { + parent::__construct($name); + $this->requiresLayout = true; + } + + public function activateOptions() { + $this->closed = false; + } + + public function close() { + $from = $this->from; + $to = $this->to; + + if (!empty($this->body) and $from !== null and $to !== null and $this->layout !== null) { + $subject = $this->subject; + LoggerLog::debug("LoggerAppenderMail::close() sending mail from=[{$from}] to=[{$to}] subject=[{$subject}]"); + mail( + $to, $subject, + $this->layout->getHeader() . $this->body . $this->layout->getFooter(), + "From: {$from}\r\n" + ); + } + $this->closed = true; + } + + /** + * @return string + */ + function getFrom() + { + return $this->from; + } + + /** + * @return string + */ + function getSubject() + { + return $this->subject; + } + + /** + * @return string + */ + function getTo() + { + return $this->to; + } + + function setSubject($subject) + { + $this->subject = $subject; + } + + function setTo($to) + { + $this->to = $to; + } + + function setFrom($from) + { + $this->from = $from; + } + + function append($event) + { + if ($this->layout !== null) + $this->body .= $this->layout->format($event); + } +} diff --git a/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderMailEvent.php b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderMailEvent.php new file mode 100644 index 0000000..8405fcb --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderMailEvent.php @@ -0,0 +1,172 @@ +Parameters are + * {@link $smtpHost} (optional), + * {@link $port} (optional), + * {@link $from} (optional), + * {@link $to}, + * {@link $subject} (optional). + *A layout is required.
+ * + * @author Domenico LordiContributors: Sergio Strampelli.
+ * + * @author Marco Vassura + * @version $Revision: 640254 $ + * @package log4php + * @subpackage appenders + */ +class LoggerAppenderRollingFile extends LoggerAppenderFile { + + /** + * Set the maximum size that the output file is allowed to reach + * before being rolled over to backup files. + * + *In configuration files, the MaxFileSize option takes a + * long integer in the range 0 - 2^63. You can specify the value + * with the suffixes "KB", "MB" or "GB" so that the integer is + * interpreted being expressed respectively in kilobytes, megabytes + * or gigabytes. For example, the value "10KB" will be interpreted + * as 10240.
+ *The default maximum file size is 10MB.
+ * + *Note that MaxFileSize cannot exceed 2 GB.
+ * + * @var integer + */ + var $maxFileSize = 10485760; + + /** + * Set the maximum number of backup files to keep around. + * + *The MaxBackupIndex option determines how many backup + * files are kept before the oldest is erased. This option takes + * a positive integer value. If set to zero, then there will be no + * backup files and the log file will be truncated when it reaches + * MaxFileSize.
+ *There is one backup file by default.
+ * + * @var integer + */ + var $maxBackupIndex = 1; + + /** + * @var string the filename expanded + * @access private + */ + var $expandedFileName = null; + + /** + * Constructor. + * + * @param string $name appender name + */ + public function __construct($name) { + parent::__construct($name); + } + + /** + * Returns the value of the MaxBackupIndex option. + * @return integer + */ + function getExpandedFileName() { + return $this->expandedFileName; + } + + /** + * Returns the value of the MaxBackupIndex option. + * @return integer + */ + function getMaxBackupIndex() { + return $this->maxBackupIndex; + } + + /** + * Get the maximum size that the output file is allowed to reach + * before being rolled over to backup files. + * @return integer + */ + function getMaximumFileSize() { + return $this->maxFileSize; + } + + /** + * Implements the usual roll over behaviour. + * + *If MaxBackupIndex is positive, then files File.1, ..., File.MaxBackupIndex -1 are renamed to File.2, ..., File.MaxBackupIndex. + * Moreover, File is renamed File.1 and closed. A new File is created to receive further log output. + * + *
If MaxBackupIndex is equal to zero, then the File is truncated with no backup files created. + */ + function rollOver() + { + // If maxBackups <= 0, then there is no file renaming to be done. + if($this->maxBackupIndex > 0) { + $fileName = $this->getExpandedFileName(); + // Delete the oldest file, to keep Windows happy. + $file = $fileName . '.' . $this->maxBackupIndex; + if (is_writable($file)) + unlink($file); + // Map {(maxBackupIndex - 1), ..., 2, 1} to {maxBackupIndex, ..., 3, 2} + for ($i = $this->maxBackupIndex - 1; $i >= 1; $i--) { + $file = $fileName . "." . $i; + if (is_readable($file)) { + $target = $fileName . '.' . ($i + 1); + rename($file, $target); + } + } + + // Rename fileName to fileName.1 + $target = $fileName . ".1"; + + $this->closeFile(); // keep windows happy. + + $file = $fileName; + rename($file, $target); + } + + $this->setFile($fileName, false); + unset($this->fp); + $this->activateOptions(); + } + + function setFileName($fileName) + { + $this->fileName = $fileName; + $this->expandedFileName = realpath($fileName); + LoggerLog::debug("LoggerAppenderRollingFile::setFileName():filename=[{$fileName}]:expandedFileName=[{$this->expandedFileName}]"); + } + + + /** + * Set the maximum number of backup files to keep around. + * + *
The MaxBackupIndex option determines how many backup + * files are kept before the oldest is erased. This option takes + * a positive integer value. If set to zero, then there will be no + * backup files and the log file will be truncated when it reaches + * MaxFileSize. + * + * @param mixed $maxBackups + */ + function setMaxBackupIndex($maxBackups) + { + if (is_numeric($maxBackups)) + $this->maxBackupIndex = abs((int)$maxBackups); + } + + /** + * Set the maximum size that the output file is allowed to reach + * before being rolled over to backup files. + * + * @param mixed $maxFileSize + * @see setMaxFileSize() + */ + function setMaximumFileSize($maxFileSize) + { + $this->setMaxFileSize($maxFileSize); + } + + /** + * Set the maximum size that the output file is allowed to reach + * before being rolled over to backup files. + *
In configuration files, the MaxFileSize option takes an
+ * long integer in the range 0 - 2^63. You can specify the value
+ * with the suffixes "KB", "MB" or "GB" so that the integer is
+ * interpreted being expressed respectively in kilobytes, megabytes
+ * or gigabytes. For example, the value "10KB" will be interpreted
+ * as 10240.
+ *
+ * @param mixed $value
+ */
+ function setMaxFileSize($value)
+ {
+ $maxFileSize = null;
+ $numpart = substr($value,0, strlen($value) -2);
+ $suffix = strtoupper(substr($value, -2));
+
+ switch ($suffix) {
+ case 'KB': $maxFileSize = (int)((int)$numpart * 1024); break;
+ case 'MB': $maxFileSize = (int)((int)$numpart * 1024 * 1024); break;
+ case 'GB': $maxFileSize = (int)((int)$numpart * 1024 * 1024 * 1024); break;
+ default:
+ if (is_numeric($value)) {
+ $maxFileSize = (int)$value;
+ }
+ }
+
+ if ($maxFileSize === null) {
+ LoggerLog::debug("LoggerAppenderRollingFile::setMaxFileSize():value=[$value] wrong declaration");
+ } else {
+ $this->maxFileSize = abs($maxFileSize);
+ }
+ }
+
+ /**
+ * @param LoggerLoggingEvent $event
+ */
+ function append($event)
+ {
+ if ($this->fp) {
+ parent::append($event);
+ if (ftell($this->fp) > $this->getMaximumFileSize())
+ $this->rollOver();
+ }
+ }
+}
diff --git a/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderSocket.php b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderSocket.php
new file mode 100644
index 0000000..75bb930
--- /dev/null
+++ b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderSocket.php
@@ -0,0 +1,245 @@
+false.
+ */
+ var $log4jNamespace = false;
+
+ /**
+ * @var LoggerXmlLayout
+ * @access private
+ */
+ var $xmlLayout = null;
+
+ /**
+ * Create a socket connection using defined parameters
+ */
+ public function activateOptions() {
+ LoggerLog::debug("LoggerAppenderSocket::activateOptions() creating a socket...");
+ $errno = 0;
+ $errstr = '';
+ $this->sp = @fsockopen($this->getRemoteHost(), $this->getPort(), $errno, $errstr, $this->getTimeout());
+ if ($errno) {
+ LoggerLog::debug("LoggerAppenderSocket::activateOptions() socket error [$errno] $errstr");
+ $this->closed = true;
+ } else {
+ LoggerLog::debug("LoggerAppenderSocket::activateOptions() socket created [".$this->sp."]");
+ if ($this->getUseXml()) {
+ $this->xmlLayout = LoggerLayout::factory('LoggerXmlLayout');
+ if ($this->xmlLayout === null) {
+ LoggerLog::debug("LoggerAppenderSocket::activateOptions() useXml is true but layout is null");
+ $this->setUseXml(false);
+ } else {
+ $this->xmlLayout->setLocationInfo($this->getLocationInfo());
+ $this->xmlLayout->setLog4jNamespace($this->getLog4jNamespace());
+ $this->xmlLayout->activateOptions();
+ }
+ }
+ $this->closed = false;
+ }
+ }
+
+ public function close() {
+ fclose($this->sp);
+ $this->closed = true;
+ }
+
+ /**
+ * @return string
+ */
+ public function getHostname() {
+ return $this->getRemoteHost();
+ }
+
+ /**
+ * @return boolean
+ */
+ public function getLocationInfo() {
+ return $this->locationInfo;
+ }
+
+ /**
+ * @return boolean
+ */
+ public function getLog4jNamespace() {
+ return $this->log4jNamespace;
+ }
+
+ /**
+ * @return integer
+ */
+ public function getPort() {
+ return $this->port;
+ }
+
+ public function getRemoteHost() {
+ return $this->remoteHost;
+ }
+
+ /**
+ * @return integer
+ */
+ public function getTimeout() {
+ return $this->timeout;
+ }
+
+ /**
+ * @var boolean
+ */
+ public function getUseXml() {
+ return $this->useXml;
+ }
+
+ public function reset() {
+ $this->close();
+ parent::reset();
+ }
+
+ /**
+ * @param mixed
+ */
+ public function setLocationInfo($flag) {
+ $this->locationInfo = LoggerOptionConverter::toBoolean($flag, $this->getLocationInfo());
+ }
+
+ /**
+ * @param mixed
+ */
+ public function setLog4jNamespace($flag) {
+ $this->log4jNamespace = LoggerOptionConverter::toBoolean($flag, $this->getLog4jNamespace());
+ }
+
+ /**
+ * @param integer
+ */
+ public function setPort($port) {
+ $port = LoggerOptionConverter::toInt($port, 0);
+ if ($port > 0 and $port < 65535)
+ $this->port = $port;
+ }
+
+ /**
+ * @param string
+ */
+ public function setRemoteHost($hostname) {
+ $this->remoteHost = $hostname;
+ }
+
+ /**
+ * @param integer
+ */
+ public function setTimeout($timeout) {
+ $this->timeout = LoggerOptionConverter::toInt($timeout, $this->getTimeout());
+ }
+
+ /**
+ * @param mixed
+ */
+ public function setUseXml($flag) {
+ $this->useXml = LoggerOptionConverter::toBoolean($flag, $this->getUseXml());
+ }
+
+ /**
+ * @param LoggerLoggingEvent
+ */
+ public function append($event) {
+ if ($this->sp) {
+
+ LoggerLog::debug("LoggerAppenderSocket::append()");
+
+ if ($this->getLocationInfo())
+ $event->getLocationInformation();
+
+ if (!$this->getUseXml()) {
+ $sEvent = serialize($event);
+ fwrite($this->sp, $sEvent, strlen($sEvent));
+ } else {
+ fwrite($this->sp, $this->xmlLayout->format($event));
+ }
+
+ // not sure about it...
+ fflush($this->sp);
+ }
+ }
+}
+
diff --git a/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderSyslog.php b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderSyslog.php
new file mode 100644
index 0000000..04d68eb
--- /dev/null
+++ b/thirdparty/apache-log4php/src/main/php/appenders/LoggerAppenderSyslog.php
@@ -0,0 +1,180 @@
+level >= FATAL to LOG_ALERT
+ * - FATAL > level >= ERROR to LOG_ERR
+ * - ERROR > level >= WARN to LOG_WARNING
+ * - WARN > level >= INFO to LOG_INFO
+ * - INFO > level >= DEBUG to LOG_DEBUG
+ *
+ * @author VxR If the setter expects a String no conversion is necessary.
+ * If it expects an int, then an attempt is made to convert 'value'
+ * to an int using new Integer(value). If the setter expects a boolean,
+ * the conversion is by new Boolean(value).
+ *
+ * @param string $name name of the property
+ * @param string $value String value of the property
+ */
+ function setProperty($name, $value)
+ {
+ LoggerLog::debug("LoggerOptionConverter::setProperty():name=[{$name}]:value=[{$value}]");
+
+ if ($value === null) return;
+
+ $method = "set" . ucfirst($name);
+
+ if (!method_exists($this->obj, $method)) {
+ LoggerLog::warn(
+ "LoggerOptionConverter::setProperty() No such setter method for [{$name}] property in " .
+ get_class($this->obj) . "."
+ );
+ } else {
+ return call_user_func(array(&$this->obj, $method), $value);
+ }
+ }
+
+ function activate()
+ {
+ LoggerLog::debug("LoggerOptionConverter::activate()");
+
+ if (method_exists($this->obj, 'activateoptions')) {
+ return call_user_func(array(&$this->obj, 'activateoptions'));
+ } else {
+ LoggerLog::debug("LoggerOptionConverter::activate() Nothing to activate.");
+ }
+ }
+}
diff --git a/thirdparty/apache-log4php/src/main/php/helpers/LoggerFormattingInfo.php b/thirdparty/apache-log4php/src/main/php/helpers/LoggerFormattingInfo.php
new file mode 100644
index 0000000..70a7f52
--- /dev/null
+++ b/thirdparty/apache-log4php/src/main/php/helpers/LoggerFormattingInfo.php
@@ -0,0 +1,63 @@
+min = -1;
+ $this->max = 0x7FFFFFFF;
+ $this->leftAlign = false;
+ }
+
+ function dump()
+ {
+ LoggerLog::debug("LoggerFormattingInfo::dump() min={$this->min}, max={$this->max}, leftAlign={$this->leftAlign}");
+ }
+}
diff --git a/thirdparty/apache-log4php/src/main/php/helpers/LoggerOptionConverter.php b/thirdparty/apache-log4php/src/main/php/helpers/LoggerOptionConverter.php
new file mode 100644
index 0000000..a26dd83
--- /dev/null
+++ b/thirdparty/apache-log4php/src/main/php/helpers/LoggerOptionConverter.php
@@ -0,0 +1,344 @@
+$key using this search criteria:
+ * - if $key is a constant then return it. Else
+ * - if $key is set in $_ENV then return it. Else
+ * - return $def.
+ *
+ * @param string $key The key to search for.
+ * @param string $def The default value to return.
+ * @return string the string value of the system property, or the default
+ * value if there is no property with that key.
+ *
+ * @static
+ */
+ public static function getSystemProperty($key, $def)
+ {
+ LoggerLog::debug("LoggerOptionConverter::getSystemProperty():key=[{$key}]:def=[{$def}].");
+
+ if (defined($key)) {
+ return (string)constant($key);
+ } elseif (isset($_ENV[$key])) {
+ return (string)$_ENV[$key];
+ } else {
+ return $def;
+ }
+ }
+
+ /**
+ * If $value is true, then true is
+ * returned. If $value is false, then
+ * true is returned. Otherwise, $default is
+ * returned.
+ *
+ * Case of value is unimportant. If $value is of form "level#full_file_classname",
+ * where full_file_classname means the class filename with path
+ * but without php extension, then the specified class' toLevel() method
+ * is called to process the specified level string; if no '#'
+ * character is present, then the default {@link LoggerLevel}
+ * class is used to process the level value. As a special case, if the $value parameter is
+ * equal to the string "NULL", then the value null will
+ * be returned. If any error occurs while converting the value to a level,
+ * the $defaultValue parameter, which may be
+ * null, is returned. Case of $value is insignificant for the level level, but is
+ * significant for the class name part, if present. The variable substitution delimeters are ${ and }.
+ *
+ * For example, if the "MY_CONSTANT" contains "value", then
+ * the call
+ * If no value could be found for the specified key, then the
+ * $props parameter is searched, if the value could not
+ * be found there, then substitution defaults to the empty string. For example, if {@link getSystemProperty()} cannot find any value for the key
+ * "inexistentKey", then the call
+ * A warn is thrown if $val contains a start delimeter "${"
+ * which is not balanced by a stop delimeter "}" and an empty string is returned.
+ * $anObject->setName("Joe");
+ * $anObject->setAge(32);
+ * $anObject->setMale(true)
+ *
+ * if such methods exist.
+ *
+ * @author Marco Vassura
+ * @version $Revision: 635069 $
+ * @package log4php
+ * @subpackage config
+ * @since 0.5
+ */
+class LoggerPropertySetter {
+
+ /**
+ * @var object the target object
+ * @access private
+ */
+ var $obj;
+
+ /**
+ * Create a new LoggerPropertySetter for the specified Object.
+ * This is done in prepartion for invoking {@link setProperty()}
+ * one or more times.
+ * @param object &$obj the object for which to set properties
+ */
+ function LoggerPropertySetter(&$obj)
+ {
+ $this->obj =& $obj;
+ }
+
+ /**
+ * Set the properties of an object passed as a parameter in one
+ * go. The properties are parsed relative to a
+ * prefix.
+ *
+ * @param object &$obj The object to configure.
+ * @param array $properties An array containing keys and values.
+ * @param string $prefix Only keys having the specified prefix will be set.
+ * @static
+ */
+ public static
+ function setPropertiesByObject(&$obj, $properties, $prefix)
+ {
+ $pSetter = new LoggerPropertySetter($obj);
+ return $pSetter->setProperties($properties, $prefix);
+ }
+
+
+ /**
+ * Set the properites for the object that match the
+ * prefix passed as parameter.
+ *
+ * @param array $properties An array containing keys and values.
+ * @param string $prefix Only keys having the specified prefix will be set.
+ */
+ function setProperties($properties, $prefix)
+ {
+ LoggerLog::debug("LoggerOptionConverter::setProperties():prefix=[{$prefix}]");
+
+ $len = strlen($prefix);
+ while (list($key,) = each($properties)) {
+ if (strpos($key, $prefix) === 0) {
+ if (strpos($key, '.', ($len + 1)) > 0)
+ continue;
+ $value = LoggerOptionConverter::findAndSubst($key, $properties);
+ $key = substr($key, $len);
+ if ($key == 'layout' and $this->obj instanceof loggerappender) {
+ continue;
+ }
+ $this->setProperty($key, $value);
+ }
+ }
+ $this->activate();
+ }
+
+ /**
+ * Set a property on this PropertySetter's Object. If successful, this
+ * method will invoke a setter method on the underlying Object. The
+ * setter is the one for the specified property name and the value is
+ * determined partly from the setter argument type and partly from the
+ * value specified in the call to this method.
+ *
+ *
+ * $s = LoggerOptionConverter::substituteVars("Value of key is ${MY_CONSTANT}.");
+ *
+ * will set the variable $s to "Value of key is value.".
+ * $s = LoggerOptionConverter::substVars("Value of inexistentKey is [${inexistentKey}]");
+ *
+ * will set $s to "Value of inexistentKey is []".
If you are embedding this layout within a {@link LoggerAppenderMail} + * or a {@link LoggerAppenderMailEvent} then make sure to set the + * LocationInfo option of that appender as well. + * @var boolean + */ + var $locationInfo = false; + + /** + * The Title option takes a String value. This option sets the + * document title of the generated HTML document. + * Defaults to 'Log4php Log Messages'. + * @var string + */ + var $title = "Log4php Log Messages"; + + /** + * Constructor + */ + function LoggerLayoutHtml() + { + return; + } + + /** + * The LocationInfo option takes a boolean value. By + * default, it is set to false which means there will be no location + * information output by this layout. If the the option is set to + * true, then the file name and line number of the statement + * at the origin of the log statement will be output. + * + *
If you are embedding this layout within a {@link LoggerAppenderMail} + * or a {@link LoggerAppenderMailEvent} then make sure to set the + * LocationInfo option of that appender as well. + */ + function setLocationInfo($flag) + { + if (is_bool($flag)) { + $this->locationInfo = $flag; + } else { + $this->locationInfo = (bool)(strtolower($flag) == 'true'); + } + } + + /** + * Returns the current value of the LocationInfo option. + */ + function getLocationInfo() + { + return $this->locationInfo; + } + + /** + * The Title option takes a String value. This option sets the + * document title of the generated HTML document. + * Defaults to 'Log4php Log Messages'. + */ + function setTitle($title) + { + $this->title = $title; + } + + /** + * @return string Returns the current value of the Title option. + */ + function getTitle() + { + return $this->title; + } + + /** + * @return string Returns the content type output by this layout, i.e "text/html". + */ + function getContentType() + { + return "text/html"; + } + + /** + * No options to activate. + */ + function activateOptions() + { + return true; + } + + /** + * @param LoggerLoggingEvent $event + * @return string + */ + function format($event) + { + $sbuf = LOG4PHP_LINE_SEP . "
| Time | " . LOG4PHP_LINE_SEP; + $sbuf .= "Thread | " . LOG4PHP_LINE_SEP; + $sbuf .= "Level | " . LOG4PHP_LINE_SEP; + $sbuf .= "Category | " . LOG4PHP_LINE_SEP; + if ($this->locationInfo) + $sbuf .= "File:Line | " . LOG4PHP_LINE_SEP; + $sbuf .= "Message | " . LOG4PHP_LINE_SEP; + $sbuf .= "
|---|
Each of the four fields can be individually enabled or + * disabled. The time format depends on the DateFormat used.
+ * + *If no dateFormat is specified it defaults to '%c'. + * See php {@link PHP_MANUAL#date} function for details.
+ * + * Params: + * - {@link $threadPrinting} (true|false) enable/disable pid reporting. + * - {@link $categoryPrefixing} (true|false) enable/disable logger category reporting. + * - {@link $contextPrinting} (true|false) enable/disable NDC reporting. + * - {@link $microSecondsPrinting} (true|false) enable/disable micro seconds reporting in timestamp. + * - {@link $dateFormat} (string) set date format. See php {@link PHP_MANUAL#date} function for details. + * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage layouts + */ +class LoggerLayoutTTCC extends LoggerLayout { + + // Internal representation of options + protected $threadPrinting = true; + protected $categoryPrefixing = true; + protected $contextPrinting = true; + protected $microSecondsPrinting = true; + + /** + * @var string date format. See {@link PHP_MANUAL#strftime} for details + */ + protected $dateFormat = '%c'; + + /** + * Constructor + * + * @param string date format + * @see dateFormat + */ + public function __construct($dateFormat = '') + { + if (!empty($dateFormat)) + $this->dateFormat = $dateFormat; + return; + } + + public function activateOptions() { + return; + } + + /** + * The ThreadPrinting option specifies whether the name of the + * current thread is part of log output or not. This is true by default. + */ + public function setThreadPrinting($threadPrinting) + { + + $this->threadPrinting = is_bool($threadPrinting) ? + $threadPrinting : + (bool)(strtolower($threadPrinting) == 'true'); + } + + /** + * @return boolean Returns value of the ThreadPrinting option. + */ + public function getThreadPrinting() { + return $this->threadPrinting; + } + + /** + * The CategoryPrefixing option specifies whether {@link Category} + * name is part of log output or not. This is true by default. + */ + public function setCategoryPrefixing($categoryPrefixing) + { + $this->categoryPrefixing = is_bool($categoryPrefixing) ? + $categoryPrefixing : + (bool)(strtolower($categoryPrefixing) == 'true'); + } + + /** + * @return boolean Returns value of the CategoryPrefixing option. + */ + public function getCategoryPrefixing() { + return $this->categoryPrefixing; + } + + /** + * The ContextPrinting option specifies log output will include + * the nested context information belonging to the current thread. + * This is true by default. + */ + public function setContextPrinting($contextPrinting) { + $this->contextPrinting = is_bool($contextPrinting) ? + $contextPrinting : + (bool)(strtolower($contextPrinting) == 'true'); + } + + /** + * @return boolean Returns value of the ContextPrinting option. + */ + public function getContextPrinting() + { + return $this->contextPrinting; + } + + /** + * The MicroSecondsPrinting option specifies if microseconds infos + * should be printed at the end of timestamp. + * This is true by default. + */ + public function setMicroSecondsPrinting($microSecondsPrinting) { + $this->microSecondsPrinting = is_bool($microSecondsPrinting) ? + $microSecondsPrinting : + (bool)(strtolower($microSecondsPrinting) == 'true'); + } + + /** + * @return boolean Returns value of the MicroSecondsPrinting option. + */ + public function getMicroSecondsPrinting() + { + return $this->microSecondsPrinting; + } + + + public function setDateFormat($dateFormat) + { + $this->dateFormat = $dateFormat; + } + + /** + * @return string + */ + public function getDateFormat() + { + return $this->dateFormat; + } + + /** + * In addition to the level of the statement and message, the + * returned string includes time, thread, category. + *Time, thread, category are printed depending on options. + * + * @param LoggerLoggingEvent $event + * @return string + */ + public function format($event) + { + $timeStamp = (float)$event->getTimeStamp(); + $format = strftime($this->dateFormat, (int)$timeStamp); + + if ($this->microSecondsPrinting) { + $usecs = floor(($timeStamp - (int)$timeStamp) * 1000); + $format .= sprintf(',%03d', $usecs); + } + + $format .= ' '; + + if ($this->threadPrinting) + $format .= '['.getmypid().'] '; + + $level = $event->getLevel(); + $format .= $level->toString().' '; + + if($this->categoryPrefixing) { + $format .= $event->getLoggerName().' '; + } + + if($this->contextPrinting) { + $ndc = $event->getNDC(); + if($ndc != null) { + $format .= $ndc.' '; + } + } + + $format .= '- '.$event->getRenderedMessage(); + $format .= LOG4PHP_LINE_SEP; + + return $format; + } + + public function ignoresThrowable() + { + return true; + } +} diff --git a/thirdparty/apache-log4php/src/main/php/layouts/LoggerPatternLayout.php b/thirdparty/apache-log4php/src/main/php/layouts/LoggerPatternLayout.php new file mode 100644 index 0000000..80208c0 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/layouts/LoggerPatternLayout.php @@ -0,0 +1,262 @@ +The goal of this class is to {@link format()} a {@link LoggerLoggingEvent} and return the results as a string. + * The results depend on the conversion pattern. + * The conversion pattern is closely related to the conversion pattern of the printf function in C. + * A conversion pattern is composed of literal text and format control expressions called conversion specifiers. + * You are free to insert any literal text within the conversion pattern.
+ * + *Each conversion specifier starts with a percent sign (%) and is followed by optional + * format modifiers and a conversion character.
+ * + *The conversion character specifies the type of data, e.g. category, priority, date, thread name. + * The format modifiers control such things as field width, padding, left and right justification.
+ * + * The following is a simple example. + * + *Let the conversion pattern be "%-5p [%t]: %m%n" and assume that the log4php environment + * was set to use a LoggerPatternLayout.
+ * + * Then the statements + *
+ * $root =& LoggerManager::getRoot();
+ * $root->debug("Message 1");
+ * $root->warn("Message 2");
+ *
+ * would yield the output
+ * + * DEBUG [main]: Message 1 + * WARN [main]: Message 2 + *+ * + *
Note that there is no explicit separator between text and conversion specifiers.
+ * + *The pattern parser knows when it has reached the end of a conversion specifier when it reads a conversion character. + * In the example above the conversion specifier %-5p means the priority of the logging event should be + * left justified to a width of five characters.
+ * + * Not all log4j conversion characters are implemented. The recognized conversion characters are: + * - c Used to output the category of the logging event. The category conversion specifier can be optionally followed by precision specifier, that is a decimal constant in brackets. + * If a precision specifier is given, then only the corresponding number of right most components of the category name will be printed. + * By default the category name is printed in full. + * For example, for the category name "a.b.c" the pattern %c{2} will output "b.c". + * - C Used to output the fully qualified class name of the caller issuing the logging request. + * This conversion specifier can be optionally followed by precision specifier, that is a decimal constant in brackets. + * If a precision specifier is given, then only the corresponding number of right most components of the class name will be printed. + * By default the class name is output in fully qualified form. + * For example, for the class name "org.apache.xyz.SomeClass", the pattern %C{1} will output "SomeClass". + * - d Used to output the date of the logging event. + * The date conversion specifier may be followed by a date format specifier enclosed between braces. + * The format specifier follows the {@link PHP_MANUAL#date} function. + * Note that the special character u is used to as microseconds replacement (to avoid replacement, + * use \u). + * For example, %d{H:i:s,u} or %d{d M Y H:i:s,u}. If no date format specifier is given then ISO8601 format is assumed. + * The date format specifier admits the same syntax as the time pattern string of the SimpleDateFormat. + * It is recommended to use the predefined log4php date formatters. + * These can be specified using one of the strings "ABSOLUTE", "DATE" and "ISO8601" for specifying + * AbsoluteTimeDateFormat, DateTimeDateFormat and respectively ISO8601DateFormat. + * For example, %d{ISO8601} or %d{ABSOLUTE}. + * - F Used to output the file name where the logging request was issued. + * - l Used to output location information of the caller which generated the logging event. + * - L Used to output the line number from where the logging request was issued. + * - m Used to output the application supplied message associated with the logging event. + * - M Used to output the method name where the logging request was issued. + * - p Used to output the priority of the logging event. + * - r Used to output the number of milliseconds elapsed since the start of + * the application until the creation of the logging event. + * - t Used to output the name of the thread that generated the logging event. + * - x Used to output the NDC (nested diagnostic context) associated with + * the thread that generated the logging event. + * - X Used to output the MDC (mapped diagnostic context) associated with + * the thread that generated the logging event. + * The X conversion character must be followed by the key for the map placed between braces, + * as in %X{clientNumber} where clientNumber is the key. + * The value in the MDC corresponding to the key will be output. + * See {@link LoggerMDC} class for more details. + * - % The sequence %% outputs a single percent sign. + * + *By default the relevant information is output as is. + * However, with the aid of format modifiers it is possible to change the minimum field width, + * the maximum field width and justification.
+ * + *The optional format modifier is placed between the percent sign and the conversion character.
+ *The first optional format modifier is the left justification flag which is just the minus (-) character. + * Then comes the optional minimum field width modifier. + * This is a decimal constant that represents the minimum number of characters to output. + * If the data item requires fewer characters, it is padded on either the left or the right until the minimum width is reached. The default is to pad on the left (right justify) but you can specify right padding with the left justification flag. The padding character is space. If the data item is larger than the minimum field width, the field is expanded to accommodate the data. + * The value is never truncated.
+ * + *This behavior can be changed using the maximum field width modifier which is designated by a period + * followed by a decimal constant. + * If the data item is longer than the maximum field, + * then the extra characters are removed from the beginning of the data item and not from the end. + * For example, it the maximum field width is eight and the data item is ten characters long, + * then the first two characters of the data item are dropped. + * This behavior deviates from the printf function in C where truncation is done from the end.
+ * + *Below are various format modifier examples for the category conversion specifier.
+ *+ * Format modifier left justify minimum width maximum width comment + * %20c false 20 none Left pad with spaces if the category name + * is less than 20 characters long. + * %-20c true 20 none Right pad with spaces if the category name + * is less than 20 characters long. + * %.30c NA none 30 Truncate from the beginning if the category name + * is longer than 30 characters. + * %20.30c false 20 30 Left pad with spaces if the category name + * is shorter than 20 characters. + * However, if category name is longer than 30 chars, + * then truncate from the beginning. + * %-20.30c true 20 30 Right pad with spaces if the category name is + * shorter than 20 chars. + * However, if category name is longer than 30 chars, + * then truncate from the beginning. + *+ * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage layouts + * @since 0.3 + */ +class LoggerPatternLayout extends LoggerLayout { + + /** + * @var string output buffer appended to when format() is invoked + */ + var $sbuf; + + /** + * @var string + */ + var $pattern; + + /** + * @var LoggerPatternConverter head chain + */ + var $head; + + var $timezone; + + /** + * Constructs a PatternLayout using the + * {@link LOG4PHP_LOGGER_PATTERN_LAYOUT_DEFAULT_LAYOUT_PATTERN}. + * The default pattern just produces the application supplied message. + */ + function LoggerPatternLayout($pattern = null) + { + if ($pattern === null) { + $this->LoggerPatternLayout(LOG4PHP_LOGGER_PATTERN_LAYOUT_DEFAULT_CONVERSION_PATTERN); + } else { + $this->pattern = $pattern; + } + } + + /** + * Set the ConversionPattern option. This is the string which + * controls formatting and consists of a mix of literal content and + * conversion specifiers. + */ + function setConversionPattern($conversionPattern) + { + $this->pattern = $conversionPattern; + $patternParser = $this->createPatternParser($this->pattern); + $this->head = $patternParser->parse(); + } + + /** + * @return string Returns the value of the ConversionPattern option. + */ + function getConversionPattern() + { + return $this->pattern; + } + + /** + * Does not do anything as options become effective + */ + function activateOptions() + { + // nothing to do. + } + + function ignoresThrowable() + { + return true; + } + + /** + * Returns LoggerPatternParser used to parse the conversion string. Subclasses + * may override this to return a subclass of PatternParser which recognize + * custom conversion characters. + * + * @param string $pattern + * @return LoggerPatternParser + */ + function createPatternParser($pattern) + { + return new LoggerPatternParser($pattern); + } + + /** + * Produces a formatted string as specified by the conversion pattern. + * + * @param LoggerLoggingEvent $event + * @return string + */ + function format($event) + { + LoggerLog::debug("LoggerPatternLayout::format()"); + + // Reset working stringbuffer + $this->sbuf = ''; + $c = $this->head; + while($c !== null) { + $c->format($this->sbuf, $event); + $c = $c->next; + } + return $this->sbuf; + } + +} diff --git a/thirdparty/apache-log4php/src/main/php/layouts/LoggerXmlLayout.php b/thirdparty/apache-log4php/src/main/php/layouts/LoggerXmlLayout.php new file mode 100644 index 0000000..1039bad --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/layouts/LoggerXmlLayout.php @@ -0,0 +1,208 @@ +Parameters: {@link $locationInfo}. + * + *
It does not output a complete well-formed XML file. + * The output is designed to be included as an external entity in a separate file to form + * a correct XML file.
+ * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage layouts + */ +class LoggerXmlLayout extends LoggerLayout { + + /** + * The LocationInfo option takes a boolean value. By default, + * it is set to false which means there will be no location + * information output by this layout. If the the option is set to + * true, then the file name and line number of the statement at the + * origin of the log statement will be output. + * @var boolean + */ + var $locationInfo = true; + + /** + * @var boolean set the elements namespace + */ + var $log4jNamespace = false; + + + /** + * @var string namespace + * @private + */ + var $_namespace = LOG4PHP_LOGGER_XML_LAYOUT_LOG4PHP_NS; + + /** + * @var string namespace prefix + * @private + */ + var $_namespacePrefix = LOG4PHP_LOGGER_XML_LAYOUT_LOG4PHP_NS_PREFIX; + + /** + * No options to activate. + */ + function activateOptions() + { + if ($this->getLog4jNamespace()) { + $this->_namespace = LOG4PHP_LOGGER_XML_LAYOUT_LOG4J_NS; + $this->_namespacePrefix = LOG4PHP_LOGGER_XML_LAYOUT_LOG4J_NS_PREFIX; + } else { + $this->_namespace = LOG4PHP_LOGGER_XML_LAYOUT_LOG4PHP_NS; + $this->_namespacePrefix = LOG4PHP_LOGGER_XML_LAYOUT_LOG4PHP_NS_PREFIX; + } + } + + /** + * @return string + */ + function getHeader() + { + return "<{$this->_namespacePrefix}:eventSet ". + "xmlns:{$this->_namespacePrefix}=\"{$this->_namespace}\" ". + "version=\"0.3\" ". + "includesLocationInfo=\"".($this->getLocationInfo() ? "true" : "false")."\"". + ">\r\n"; + } + + /** + * Formats a {@link LoggerLoggingEvent} in conformance with the log4php.dtd. + * + * @param LoggerLoggingEvent $event + * @return string + */ + function format($event) + { + $loggerName = $event->getLoggerName(); + $timeStamp = number_format((float)($event->getTimeStamp() * 1000), 0, '', ''); + $thread = $event->getThreadName(); + $level = $event->getLevel(); + $levelStr = $level->toString(); + + $buf = "<{$this->_namespacePrefix}:event logger=\"{$loggerName}\" level=\"{$levelStr}\" thread=\"{$thread}\" timestamp=\"{$timeStamp}\">\r\n"; + $buf .= "<{$this->_namespacePrefix}:message>getRenderedMessage()); + $buf .= "]]>_namespacePrefix}:message>\r\n"; + + $ndc = $event->getNDC(); + if($ndc != null) { + $buf .= "<{$this->_namespacePrefix}:NDC>_namespacePrefix}:NDC>\r\n"; + } + + if ($this->getLocationInfo()) { + $locationInfo = $event->getLocationInformation(); + $buf .= "<{$this->_namespacePrefix}:locationInfo ". + "class=\"" . $locationInfo->getClassName() . "\" ". + "file=\"" . htmlentities($locationInfo->getFileName(), ENT_QUOTES) . "\" ". + "line=\"" . $locationInfo->getLineNumber() . "\" ". + "method=\"" . $locationInfo->getMethodName() . "\" "; + $buf .= "/>\r\n"; + + } + + $buf .= "_namespacePrefix}:event>\r\n\r\n"; + + return $buf; + + } + + /** + * @return string + */ + function getFooter() + { + + return "_namespacePrefix}:eventSet>\r\n"; + } + + /** + * @return boolean + */ + function getLocationInfo() + { + return $this->locationInfo; + } + + /** + * @return boolean + */ + function getLog4jNamespace() + { + return $this->log4jNamespace; + } + + /** + * The XMLLayout prints and does not ignore exceptions. Hence the + * return value false. + * @return boolean + */ + function ignoresThrowable() + { + return false; + } + + /** + * The {@link $locationInfo} option takes a boolean value. By default, + * it is set to false which means there will be no location + * information output by this layout. If the the option is set to + * true, then the file name and line number of the statement at the + * origin of the log statement will be output. + */ + function setLocationInfo($flag) + { + $this->locationInfo = LoggerOptionConverter::toBoolean($flag, true); + } + + /** + * @param boolean + */ + function setLog4jNamespace($flag) + { + $this->log4jNamespace = LoggerOptionConverter::toBoolean($flag, true); + } +} + diff --git a/thirdparty/apache-log4php/src/main/php/or/LoggerDefaultRenderer.php b/thirdparty/apache-log4php/src/main/php/or/LoggerDefaultRenderer.php new file mode 100644 index 0000000..0974494 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/or/LoggerDefaultRenderer.php @@ -0,0 +1,51 @@ +map = array(); + $this->defaultRenderer = new LoggerDefaultRenderer(); + } + + /** + * Add a renderer to a hierarchy passed as parameter. + * Note that hierarchy must implement getRendererMap() and setRenderer() methods. + * + * @param LoggerHierarchy $repository a logger repository. + * @param string $renderedClassName + * @param string $renderingClassName + * @static + */ + public static function addRenderer($repository, $renderedClassName, $renderingClassName) + { + LoggerLog::debug("LoggerRendererMap::addRenderer() Rendering class: [{$renderingClassName}], Rendered class: [{$renderedClassName}]."); + $renderer = LoggerObjectRenderer::factory($renderingClassName); + if($renderer == null) { + LoggerLog::warn("LoggerRendererMap::addRenderer() Could not instantiate renderer [{$renderingClassName}]."); + return; + } else { + $repository->setRenderer($renderedClassName, $renderer); + } + } + + + /** + * Find the appropriate renderer for the class type of the + * o parameter. + * + * This is accomplished by calling the {@link getByObject()} + * method if o is object or using {@link LoggerDefaultRenderer}. + * Once a renderer is found, it is applied on the object o and + * the result is returned as a string. + * + * @param mixed $o + * @return string + */ + public function findAndRender($o) + { + if($o == null) { + return null; + } else { + if (is_object($o)) { + $renderer = $this->getByObject($o); + if ($renderer !== null) { + return $renderer->doRender($o); + } else { + return null; + } + } else { + $renderer = $this->defaultRenderer; + return $renderer->doRender($o); + } + } + } + + /** + * Syntactic sugar method that calls {@link PHP_MANUAL#get_class} with the + * class of the object parameter. + * + * @param mixed $o + * @return string + */ + public function getByObject($o) + { + return ($o == null) ? null : $this->getByClassName(get_class($o)); + } + + + /** + * Search the parents of clazz for a renderer. + * + * The renderer closest in the hierarchy will be returned. If no + * renderers could be found, then the default renderer is returned. + * + * @param string $class + * @return LoggerObjectRenderer + */ + public function getByClassName($class) + { + $r = null; + for($c = strtolower($class); !empty($c); $c = get_parent_class($c)) { + if (isset($this->map[$c])) { + return $this->map[$c]; + } + } + return $this->defaultRenderer; + } + + /** + * @return LoggerDefaultRenderer + */ + public function getDefaultRenderer() + { + return $this->defaultRenderer; + } + + + public function clear() + { + $this->map = array(); + } + + /** + * Register a {@link LoggerObjectRenderer} for clazz. + * @param string $class + * @param LoggerObjectRenderer $or + */ + public function put($class, $or) + { + $this->map[strtolower($class)] = $or; + } + + /** + * @param string $class + * @return boolean + */ + public function rendererExists($class) + { + $class = basename($class); + if (!class_exists($class)) { + include_once(LOG4PHP_DIR ."/or/{$class}.php"); + } + return class_exists($class); + } +} diff --git a/thirdparty/apache-log4php/src/main/php/spi/LoggerConfigurator.php b/thirdparty/apache-log4php/src/main/php/spi/LoggerConfigurator.php new file mode 100644 index 0000000..555b6c7 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/spi/LoggerConfigurator.php @@ -0,0 +1,62 @@ +inherited. + * {@link LOG4PHP_LOGGER_CONFIGURATOR_NULL} is a synonym. + */ +define('LOG4PHP_LOGGER_CONFIGURATOR_INHERITED', 'inherited'); + +/** + * Special level signifying inherited behaviour, same as + * {@link LOG4PHP_LOGGER_CONFIGURATOR_INHERITED}. + * The current value of this string constant is null. + */ +define('LOG4PHP_LOGGER_CONFIGURATOR_NULL', 'null'); + +/** + * Implemented by classes capable of configuring log4php using a URL. + * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage spi + */ +interface LoggerConfigurator { + + /** + * Interpret a resource pointed by a url and configure accordingly. + * + * The configuration is done relative to the repository + * parameter. + * + * @param string $url The URL to parse + */ + public static function configure($url=null); + +} diff --git a/thirdparty/apache-log4php/src/main/php/spi/LoggerFactory.php b/thirdparty/apache-log4php/src/main/php/spi/LoggerFactory.php new file mode 100644 index 0000000..08d793a --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/spi/LoggerFactory.php @@ -0,0 +1,50 @@ +This abstract class assumes and also imposes that filters be + * organized in a linear chain. The {@link #decide + * decide(LoggerLoggingEvent)} method of each filter is called sequentially, + * in the order of their addition to the chain. + * + *The {@link decide()} method must return one + * of the integer constants {@link LOG4PHP_LOG4PHP_LOGGER_FILTER_DENY}, + * {@link LOG4PHP_LOGGER_FILTER_NEUTRAL} or {@link LOG4PHP_LOGGER_FILTER_ACCEPT}. + * + *
If the value {@link LOG4PHP_LOGGER_FILTER_DENY} is returned, then the log event is + * dropped immediately without consulting with the remaining + * filters. + * + *
If the value {@link LOG4PHP_LOGGER_FILTER_NEUTRAL} is returned, then the next filter + * in the chain is consulted. If there are no more filters in the + * chain, then the log event is logged. Thus, in the presence of no + * filters, the default behaviour is to log all logging events. + * + *
If the value {@link LOG4PHP_LOGGER_FILTER_ACCEPT} is returned, then the log + * event is logged without consulting the remaining filters. + * + *
The philosophy of log4php filters is largely inspired from the + * Linux ipchains. + * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage spi + */ +class LoggerFilter { + + /** + * @var LoggerFilter Points to the next {@link LoggerFilter} in the filter chain. + */ + protected $next; + + /** + * Usually filters options become active when set. We provide a + * default do-nothing implementation for convenience. + */ + public function activateOptions() + { + return; + } + + /** + * Decide what to do. + *
If the decision is {@link LOG4PHP_LOGGER_FILTER_DENY}, then the event will be + * dropped. If the decision is {@link LOG4PHP_LOGGER_FILTER_NEUTRAL}, then the next + * filter, if any, will be invoked. If the decision is {@link LOG4PHP_LOGGER_FILTER_ACCEPT} then + * the event will be logged without consulting with other filters in + * the chain. + * + * @param LoggerLoggingEvent $event The {@link LoggerLoggingEvent} to decide upon. + * @return integer {@link LOG4PHP_LOGGER_FILTER_NEUTRAL} or {@link LOG4PHP_LOGGER_FILTER_DENY}|{@link LOG4PHP_LOGGER_FILTER_ACCEPT} + */ + public function decide($event) + { + return LOG4PHP_LOGGER_FILTER_NEUTRAL; + } + + public function getNext() { + return $this->next; + } + +} diff --git a/thirdparty/apache-log4php/src/main/php/spi/LoggerLocationInfo.php b/thirdparty/apache-log4php/src/main/php/spi/LoggerLocationInfo.php new file mode 100644 index 0000000..941adcf --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/spi/LoggerLocationInfo.php @@ -0,0 +1,118 @@ +NA is returned. Current value of this string + * constant is ?. + */ +define('LOG4PHP_LOGGER_LOCATION_INFO_NA', 'NA'); + +/** + * The internal representation of caller location information. + * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage spi + * @since 0.3 + */ +class LoggerLocationInfo { + + /** + * @var string Caller's line number. + */ + protected $lineNumber = null; + + /** + * @var string Caller's file name. + */ + protected $fileName = null; + + /** + * @var string Caller's fully qualified class name. + */ + protected $className = null; + + /** + * @var string Caller's method name. + */ + protected $methodName = null; + + /** + * @var string + */ + protected $fullInfo = null; + + /** + * Instantiate location information based on a {@link PHP_MANUAL#debug_backtrace}. + * + * @param array $trace + * @param mixed $caller + */ + public function __construct($trace, $fqcn = null) + { + $this->lineNumber = isset($trace['line']) ? $trace['line'] : null; + $this->fileName = isset($trace['file']) ? $trace['file'] : null; + $this->className = isset($trace['class']) ? $trace['class'] : null; + $this->methodName = isset($trace['function']) ? $trace['function'] : null; + + $this->fullInfo = $this->getClassName() . '.' . $this->getMethodName() . + '(' . $this->getFileName() . ':' . $this->getLineNumber() . ')'; + } + + public function getClassName() + { + return ($this->className === null) ? LOG4PHP_LOGGER_LOCATION_INFO_NA : $this->className; + } + + /** + * Return the file name of the caller. + *
This information is not always available. + */ + public function getFileName() + { + return ($this->fileName === null) ? LOG4PHP_LOGGER_LOCATION_INFO_NA : $this->fileName; + } + + /** + * Returns the line number of the caller. + *
This information is not always available. + */ + public function getLineNumber() + { + return ($this->lineNumber === null) ? LOG4PHP_LOGGER_LOCATION_INFO_NA : $this->lineNumber; + } + + /** + * Returns the method name of the caller. + */ + public function getMethodName() + { + return ($this->methodName === null) ? LOG4PHP_LOGGER_LOCATION_INFO_NA : $this->methodName; + } +} diff --git a/thirdparty/apache-log4php/src/main/php/spi/LoggerLoggingEvent.php b/thirdparty/apache-log4php/src/main/php/spi/LoggerLoggingEvent.php new file mode 100644 index 0000000..e0b039a --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/spi/LoggerLoggingEvent.php @@ -0,0 +1,377 @@ + This field should not be accessed directly. You shoud use the + * {@link getLevel()} method instead. + * + * @deprecated + * @var LoggerLevel + */ + protected $level; + + /** + * @var string The nested diagnostic context (NDC) of logging event. + */ + var $ndc; + + /** + * Have we tried to do an NDC lookup? If we did, there is no need + * to do it again. Note that its value is always false when + * serialized. Thus, a receiving SocketNode will never use it's own + * (incorrect) NDC. See also writeObject method. + * @var boolean + */ + var $ndcLookupRequired = true; + + /** + * Have we tried to do an MDC lookup? If we did, there is no need + * to do it again. Note that its value is always false when + * serialized. See also the getMDC and getMDCCopy methods. + * @var boolean + */ + var $mdcCopyLookupRequired = true; + + /** + * @var mixed The application supplied message of logging event. + */ + var $message; + + /** + * The application supplied message rendered through the log4php + * objet rendering mechanism. At present renderedMessage == message. + * @var string + */ + var $renderedMessage = null; + + /** + * The name of thread in which this logging event was generated. + * log4php saves here the process id via {@link PHP_MANUAL#getmypid getmypid()} + * @var mixed + */ + var $threadName = null; + + /** + * The number of seconds elapsed from 1/1/1970 until logging event + * was created plus microseconds if available. + * @var float + */ + public $timeStamp; + + /** + * @var LoggerLocationInfo Location information for the caller. + */ + var $locationInfo = null; + + /** + * Instantiate a LoggingEvent from the supplied parameters. + * + *
Except {@link $timeStamp} all the other fields of + * LoggerLoggingEvent are filled when actually needed. + * + * @param string $fqcn name of the caller class. + * @param mixed $logger The {@link Logger} category of this event or the logger name. + * @param LoggerLevel $priority The level of this event. + * @param mixed $message The message of this event. + * @param integer $timeStamp the timestamp of this logging event. + */ + public function __construct($fqcn, $logger, $priority, $message, $timeStamp = null) + { + $this->fqcn = $fqcn; + if ($logger instanceof Logger) { + $this->logger = $logger; + $this->categoryName = $logger->getName(); + } else { + $this->categoryName = strval($logger); + } + $this->level = $priority; + $this->message = $message; + if ($timeStamp !== null && is_float($timeStamp)) { + $this->timeStamp = $timeStamp; + } else { + if (function_exists('microtime')) { + // get microtime as float + $this->timeStamp = microtime(true); + } else { + $this->timeStamp = floatval(time()); + } + } + } + + /** + * Set the location information for this logging event. The collected + * information is cached for future use. + * + *
This method uses {@link PHP_MANUAL#debug_backtrace debug_backtrace()} function (if exists) + * to collect informations about caller.
+ *It only recognize informations generated by {@link Logger} and its subclasses.
+ * @return LoggerLocationInfo + */ + public function getLocationInformation() + { + if($this->locationInfo === null) { + + $locationInfo = array(); + + if (function_exists('debug_backtrace')) { + $trace = debug_backtrace(); + $prevHop = null; + // make a downsearch to identify the caller + $hop = array_pop($trace); + while ($hop !== null) { + $className = @strtolower($hop['class']); + if ( !empty($className) and ($className == 'logger' or $className == 'loggercategory' or + get_parent_class($className) == 'logger') or get_parent_class($className) == 'loggercategory') { + $locationInfo['line'] = $hop['line']; + $locationInfo['file'] = $hop['file']; + break; + } + $prevHop = $hop; + $hop = array_pop($trace); + } + $locationInfo['class'] = isset($prevHop['class']) ? $prevHop['class'] : 'main'; + if (isset($prevHop['function']) and + $prevHop['function'] !== 'include' and + $prevHop['function'] !== 'include_once' and + $prevHop['function'] !== 'require' and + $prevHop['function'] !== 'require_once') { + + $locationInfo['function'] = $prevHop['function']; + } else { + $locationInfo['function'] = 'main'; + } + } + + $this->locationInfo = new LoggerLocationInfo($locationInfo, $this->fqcn); + } + return $this->locationInfo; + } + + /** + * Return the level of this event. Use this form instead of directly + * accessing the {@link $level} field. + * @return LoggerLevel + */ + public function getLevel() + { + return $this->level; + } + + /** + * Return the name of the logger. Use this form instead of directly + * accessing the {@link $categoryName} field. + * @return string + */ + public function getLoggerName() + { + return $this->categoryName; + } + + /** + * Return the message for this logging event. + * + *Before serialization, the returned object is the message
+ * passed by the user to generate the logging event. After
+ * serialization, the returned value equals the String form of the
+ * message possibly after object rendering.
+ * @return mixed
+ */
+ public function getMessage()
+ {
+ if($this->message !== null) {
+ return $this->message;
+ } else {
+ return $this->getRenderedMessage();
+ }
+ }
+
+ /**
+ * This method returns the NDC for this event. It will return the
+ * correct content even if the event was generated in a different
+ * thread or even on a different machine. The {@link LoggerNDC::get()} method
+ * should never be called directly.
+ * @return string
+ */
+ public function getNDC()
+ {
+ if ($this->ndcLookupRequired) {
+ $this->ndcLookupRequired = false;
+ $this->ndc = implode(' ',LoggerNDC::get());
+ }
+ return $this->ndc;
+ }
+
+
+ /**
+ * Returns the the context corresponding to the key
+ * parameter.
+ * @return string
+ */
+ public function getMDC($key)
+ {
+ return LoggerMDC::get($key);
+ }
+
+ /**
+ * Render message.
+ * @return string
+ */
+ public function getRenderedMessage()
+ {
+ if($this->renderedMessage === null and $this->message !== null) {
+ if (is_string($this->message)) {
+ $this->renderedMessage = $this->message;
+ } else {
+ if ($this->logger !== null) {
+ $repository = $this->logger->getLoggerRepository();
+ } else {
+ $repository = LoggerManager::getLoggerRepository();
+ }
+ if (method_exists($repository, 'getRendererMap')) {
+ $rendererMap = $repository->getRendererMap();
+ $this->renderedMessage= $rendererMap->findAndRender($this->message);
+ } else {
+ $this->renderedMessage = (string)$this->message;
+ }
+ }
+ }
+ return $this->renderedMessage;
+ }
+
+ /**
+ * Returns the time when the application started, in seconds
+ * elapsed since 01.01.1970 plus microseconds if available.
+ *
+ * @return float
+ * @static
+ */
+ public static function getStartTime() {
+ if (!isset(self::$startTime)) {
+ if (function_exists('microtime')) {
+ // microtime as float
+ self::$startTime = microtime(true);
+ } else {
+ self::$startTime = floatval(time());
+ }
+ }
+ return self::$startTime;
+ }
+
+ /**
+ * @return float
+ */
+ public function getTimeStamp()
+ {
+ return $this->timeStamp;
+ }
+
+ /**
+ * @return mixed
+ */
+ public function getThreadName()
+ {
+ if ($this->threadName === null)
+ $this->threadName = (string)getmypid();
+ return $this->threadName;
+ }
+
+ /**
+ * @return mixed null
+ */
+ public function getThrowableInformation()
+ {
+ return null;
+ }
+
+ /**
+ * Serialize this object
+ * @return string
+ */
+ public function toString()
+ {
+ serialize($this);
+ }
+
+ /**
+ * Avoid serialization of the {@link $logger} object
+ */
+ public function __sleep()
+ {
+ return array(
+ 'fqcn','categoryName',
+ 'level',
+ 'ndc','ndcLookupRequired',
+ 'message','renderedMessage',
+ 'threadName',
+ 'timeStamp',
+ 'locationInfo'
+ );
+ }
+
+}
+
+LoggerLoggingEvent::getStartTime();
+
diff --git a/thirdparty/apache-log4php/src/main/php/varia/LoggerDenyAllFilter.php b/thirdparty/apache-log4php/src/main/php/varia/LoggerDenyAllFilter.php
new file mode 100644
index 0000000..31022f7
--- /dev/null
+++ b/thirdparty/apache-log4php/src/main/php/varia/LoggerDenyAllFilter.php
@@ -0,0 +1,59 @@
+You can add this filter to the end of a filter chain to
+ * switch from the default "accept all unless instructed otherwise"
+ * filtering behaviour to a "deny all unless instructed otherwise"
+ * behaviour.
If the level of the {@link LoggerLoggingEvent} is not between Min and Max + * (inclusive), then {@link LOG4PHP_LOGGER_FILTER_DENY} is returned.
+ * + *If the Logging event level is within the specified range, then if + * AcceptOnMatch is true, + * {@link LOG4PHP_LOGGER_FILTER_ACCEPT} is returned, and if + * AcceptOnMatch is false, + * {@link LOG4PHP_LOGGER_FILTER_NEUTRAL} is returned.
+ * + *If LevelMin is not defined, then there is no + * minimum acceptable level (i.e. a level is never rejected for + * being too "low"/unimportant). If LevelMax is not + * defined, then there is no maximum acceptable level (ie a + * level is never rejected for being too "high"/important).
+ * + *Refer to the {@link LoggerAppenderSkeleton::setThreshold()} method + * available to all appenders extending {@link LoggerAppenderSkeleton} + * for a more convenient way to filter out events by level.
+ * + * @log4j-class org.apache.log4j.varia.LevelRangeFilter + * @log4j-author Simon Kitching + * @log4j-author based on code by Ceki Gülcü + * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage varia + * @since 0.6 + */ +class LoggerLevelRangeFilter extends LoggerFilter { + + /** + * @var boolean + */ + var $acceptOnMatch = true; + + /** + * @var LoggerLevel + */ + var $levelMin; + + /** + * @var LoggerLevel + */ + var $levelMax; + + /** + * @return boolean + */ + function getAcceptOnMatch() + { + return $this->acceptOnMatch; + } + + /** + * @param boolean $acceptOnMatch + */ + function setAcceptOnMatch($acceptOnMatch) + { + $this->acceptOnMatch = LoggerOptionConverter::toBoolean($acceptOnMatch, true); + } + + /** + * @return LoggerLevel + */ + function getLevelMin() + { + return $this->levelMin; + } + + /** + * @param string $l the level min to match + */ + function setLevelMin($l) + { + $this->levelMin = LoggerOptionConverter::toLevel($l, null); + } + + /** + * @return LoggerLevel + */ + function getLevelMax() + { + return $this->levelMax; + } + + /** + * @param string $l the level max to match + */ + function setLevelMax($l) + { + $this->levelMax = LoggerOptionConverter::toLevel($l, null); + } + + /** + * Return the decision of this filter. + * + * @param LoggerLoggingEvent $event + * @return integer + */ + function decide($event) + { + $level = $event->getLevel(); + + if($this->levelMin !== null) { + if ($level->isGreaterOrEqual($this->levelMin) == false) { + // level of event is less than minimum + return LOG4PHP_LOGGER_FILTER_DENY; + } + } + + if($this->levelMax !== null) { + if ($level->toInt() > $this->levelMax->toInt()) { + // level of event is greater than maximum + // Alas, there is no Level.isGreater method. and using + // a combo of isGreaterOrEqual && !Equal seems worse than + // checking the int values of the level objects.. + return LOG4PHP_LOGGER_FILTER_DENY; + } + } + + if ($this->getAcceptOnMatch()) { + // this filter set up to bypass later filters and always return + // accept if level in range + return LOG4PHP_LOGGER_FILTER_ACCEPT; + } else { + // event is ok for this filter; allow later filters to have a look.. + return LOG4PHP_LOGGER_FILTER_NEUTRAL; + } + } +} diff --git a/thirdparty/apache-log4php/src/main/php/varia/LoggerStringMatchFilter.php b/thirdparty/apache-log4php/src/main/php/varia/LoggerStringMatchFilter.php new file mode 100644 index 0000000..80c5b58 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/varia/LoggerStringMatchFilter.php @@ -0,0 +1,110 @@ +The filter admits two options {@link $stringToMatch} and + * {@link $acceptOnMatch}. If there is a match (using {@link PHP_MANUAL#strpos} + * between the value of the {@link $stringToMatch} option and the message + * of the {@link LoggerLoggingEvent}, + * then the {@link decide()} method returns {@link LOG4PHP_LOGGER_FILTER_ACCEPT} if + * the AcceptOnMatch option value is true, if it is false then + * {@link LOG4PHP_LOGGER_FILTER_DENY} is returned. If there is no match, {@link LOG4PHP_LOGGER_FILTER_NEUTRAL} + * is returned. + * + * @author Marco Vassura + * @version $Revision: 635069 $ + * @package log4php + * @subpackage varia + * @since 0.3 + */ +class LoggerStringMatchFilter extends LoggerFilter { + + /** + * @var boolean + */ + var $acceptOnMatch = true; + + /** + * @var string + */ + var $stringToMatch = null; + + /** + * @return boolean + */ + function getAcceptOnMatch() + { + return $this->acceptOnMatch; + } + + /** + * @param mixed $acceptOnMatch a boolean or a string ('true' or 'false') + */ + function setAcceptOnMatch($acceptOnMatch) + { + $this->acceptOnMatch = is_bool($acceptOnMatch) ? + $acceptOnMatch : + (bool)(strtolower($acceptOnMatch) == 'true'); + } + + /** + * @return string + */ + function getStringToMatch() + { + return $this->stringToMatch; + } + + /** + * @param string $s the string to match + */ + function setStringToMatch($s) + { + $this->stringToMatch = $s; + } + + /** + * @return integer a {@link LOGGER_FILTER_NEUTRAL} is there is no string match. + */ + function decide($event) + { + $msg = $event->getRenderedMessage(); + + if($msg === null or $this->stringToMatch === null) + return LOG4PHP_LOGGER_FILTER_NEUTRAL; + if( strpos($msg, $this->stringToMatch) !== false ) { + return ($this->acceptOnMatch) ? LOG4PHP_LOGGER_FILTER_ACCEPT : LOG4PHP_LOGGER_FILTER_DENY ; + } + return LOG4PHP_LOGGER_FILTER_NEUTRAL; + } +} diff --git a/thirdparty/apache-log4php/src/main/php/xml/LoggerDOMConfigurator.php b/thirdparty/apache-log4php/src/main/php/xml/LoggerDOMConfigurator.php new file mode 100644 index 0000000..b5505b3 --- /dev/null +++ b/thirdparty/apache-log4php/src/main/php/xml/LoggerDOMConfigurator.php @@ -0,0 +1,611 @@ + +Read the log4php.dtd included in the documentation directory. Note that + * php parser does not validate the document.
+ * + *Sometimes it is useful to see how log4php is reading configuration + * files. You can enable log4php internal logging by setting the debug + * attribute in the log4php:configuration element. As in + *
+ * <log4php:configuration debug="true" xmlns:log4php="http://logging.apache.org/log4php/"> + * ... + * </log4php:configuration> + *+ * + *
There are sample XML files included in the package under tests/ + * subdirectories.
+ * + * @author Marco Vassura + * @author Knut Urdalen