powerdlz23 1.1.6 → 1.1.8

package/pto/yaamp/web/framework-1.0.8/logging/CLogRoute.php

@@ -0,0 +1,107 @@
+<?php
+/**
+ * CLogRoute class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CLogRoute is the base class for all log route classes.
+ *
+ * A log route object retrieves log messages from a logger and sends it
+ * somewhere, such as files, emails.
+ * The messages being retrieved may be filtered first before being sent
+ * to the destination. The filters include log level filter and log category filter.
+ *
+ * To specify level filter, set {@link levels} property,
+ * which takes a string of comma-separated desired level names (e.g. 'Error, Debug').
+ * To specify category filter, set {@link categories} property,
+ * which takes a string of comma-separated desired category names (e.g. 'System.Web, System.IO').
+ *
+ * Level filter and category filter are combinational, i.e., only messages
+ * satisfying both filter conditions will they be returned.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CLogRoute.php 1165 2009-06-22 21:23:30Z qiang.xue $
+ * @package system.logging
+ * @since 1.0
+ */
+abstract class CLogRoute extends CComponent
+{
+	/**
+	 * @var boolean whether to enable this log route. Defaults to true.
+	 * @since 1.0.7
+	 */
+	public $enabled=true;
+	/**
+	 * @var string list of levels separated by comma or space. Defaults to empty, meaning all levels.
+	 */
+	public $levels='';
+	/**
+	 * @var string list of categories separated by comma or space. Defaults to empty, meaning all categories.
+	 */
+	public $categories='';
+	/**
+	 * @var mixed the additional filter (e.g. {@link CLogFilter}) that can be applied to the log messages.
+	 * The value of this property will be passed to {@link Yii::createComponent} to create
+	 * a log filter object. As a result, this can be either a string representing the
+	 * filter class name or an array representing the filter configuration.
+	 * In general, the log filter class should be {@link CLogFilter} or a child class of it.
+	 * Defaults to null, meaning no filter will be used.
+	 * @since 1.0.6
+	 */
+	public $filter;
+
+
+	/**
+	 * Initializes the route.
+	 * This method is invoked after the route is created by the route manager.
+	 */
+	public function init()
+	{
+	}
+
+	/**
+	 * Formats a log message given different fields.
+	 * @param string message content
+	 * @param integer message level
+	 * @param string message category
+	 * @param integer timestamp
+	 * @return string formatted message
+	 */
+	protected function formatLogMessage($message,$level,$category,$time)
+	{
+		return @date('Y/m/d H:i:s',$time)." [$level] [$category] $message\n";
+	}
+
+	/**
+	 * Retrieves filtered log messages from logger for further processing.
+	 * @param CLogger logger instance
+	 */
+	public function collectLogs($logger)
+	{
+		$logs=$logger->getLogs($this->levels,$this->categories);
+		if(!empty($logs))
+		{
+			if($this->filter!==null)
+				Yii::createComponent($this->filter)->filter($logs);
+			$this->processLogs($logs);
+		}
+	}
+
+	/**
+	 * Processes log messages and sends them to specific destination.
+	 * Derived child classes must implement this method.
+	 * @param array list of messages.  Each array elements represents one message
+	 * with the following structure:
+	 * array(
+	 *   [0] => message (string)
+	 *   [1] => level (string)
+	 *   [2] => category (string)
+	 *   [3] => timestamp (float, obtained by microtime(true));
+	 */
+	abstract protected function processLogs($logs);
+}

package/pto/yaamp/web/framework-1.0.8/logging/CLogRouter.php

@@ -0,0 +1,107 @@
+<?php
+/**
+ * CLogRouter class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CLogRouter manages log routes that record log messages in different media.
+ *
+ * For example, a file log route {@link CFileLogRoute} records log messages
+ * in log files. An email log route {@link CEmailLogRoute} sends log messages
+ * to specific email addresses. See {@link CLogRoute} for more details about
+ * different log routes.
+ *
+ * Log routes may be configured in application configuration like following:
+ * <pre>
+ * array(
+ *     'preload'=>array('log'), // preload log component when app starts
+ *     'components'=>array(
+ *         'log'=>array(
+ *             'class'=>'CLogRouter',
+ *             'routes'=>array(
+ *                 array(
+ *                     'class'=>'CFileLogRoute',
+ *                     'levels'=>'trace, info',
+ *                     'categories'=>'system.*',
+ *                 ),
+ *                 array(
+ *                     'class'=>'CEmailLogRoute',
+ *                     'levels'=>'error, warning',
+ *                     'email'=>'admin@example.com',
+ *                 ),
+ *             ),
+ *         ),
+ *     ),
+ * )
+ * </pre>
+ *
+ * You can specify multiple routes with different filtering conditions and different
+ * targets, even if the routes are of the same type.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CLogRouter.php 1184 2009-06-28 00:30:10Z qiang.xue $
+ * @package system.logging
+ * @since 1.0
+ */
+class CLogRouter extends CApplicationComponent
+{
+	private $_routes=array();
+
+	/**
+	 * Initializes this application component.
+	 * This method is required by the IApplicationComponent interface.
+	 */
+	public function init()
+	{
+		parent::init();
+		foreach($this->_routes as $name=>$route)
+		{
+			$route=Yii::createComponent($route);
+			$route->init();
+			$this->_routes[$name]=$route;
+		}
+		Yii::app()->attachEventHandler('onEndRequest',array($this,'collectLogs'));
+	}
+
+	/**
+	 * @return array the currently initialized routes
+	 */
+	public function getRoutes()
+	{
+		return new CMap($this->_routes);
+	}
+
+	/**
+	 * @param array list of route configurations. Each array element represents
+	 * the configuration for a single route and has the following array structure:
+	 * <ul>
+	 * <li>class: specifies the class name or alias for the route class.</li>
+	 * <li>name-value pairs: configure the initial property values of the route.</li>
+	 * </ul>
+	 */
+	public function setRoutes($config)
+	{
+		foreach($config as $name=>$route)
+			$this->_routes[$name]=$route;
+	}
+
+	/**
+	 * Collects log messages from a logger.
+	 * This method is an event handler to application's onEndRequest event.
+	 * @param mixed event parameter
+	 */
+	public function collectLogs($param)
+	{
+		$logger=Yii::getLogger();
+		foreach($this->_routes as $route)
+		{
+			if($route->enabled)
+				$route->collectLogs($logger);
+		}
+	}
+}

package/pto/yaamp/web/framework-1.0.8/logging/CLogger.php

@@ -0,0 +1,237 @@
+<?php
+/**
+ * CLogger class file
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CLogger records log messages in memory.
+ *
+ * CLogger implements the methods to retrieve the messages with
+ * various filter conditions, including log levels and log categories.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CLogger.php 1042 2009-05-21 19:53:47Z qiang.xue $
+ * @package system.logging
+ * @since 1.0
+ */
+class CLogger extends CComponent
+{
+	const LEVEL_TRACE='trace';
+	const LEVEL_WARNING='warning';
+	const LEVEL_ERROR='error';
+	const LEVEL_INFO='info';
+	const LEVEL_PROFILE='profile';
+
+	/**
+	 * @var array log messages
+	 */
+	private $_logs=array();
+	/**
+	 * @var array log levels for filtering (used when filtering)
+	 */
+	private $_levels;
+	/**
+	 * @var array log categories for filtering (used when filtering)
+	 */
+	private $_categories;
+	/**
+	 * @var array the profiling results (category, token => time in seconds)
+	 * @since 1.0.6
+	 */
+	private $_timings;
+
+	/**
+	 * Logs a message.
+	 * Messages logged by this method may be retrieved back via {@link getLogs}.
+	 * @param string message to be logged
+	 * @param string level of the message (e.g. 'Trace', 'Warning', 'Error'). It is case-insensitive.
+	 * @param string category of the message (e.g. 'system.web'). It is case-insensitive.
+	 * @see getLogs
+	 */
+	public function log($message,$level='info',$category='application')
+	{
+		$this->_logs[]=array($message,$level,$category,microtime(true));
+	}
+
+	/**
+	 * Retrieves log messages.
+	 *
+	 * Messages may be filtered by log levels and/or categories.
+	 * A level filter is specified by a list of levels separated by comma or space
+	 * (e.g. 'trace, error'). A category filter is similar to level filter
+	 * (e.g. 'system, system.web'). A difference is that in category filter
+	 * you can use pattern like 'system.*' to indicate all categories starting
+	 * with 'system'.
+	 *
+	 * If you do not specify level filter, it will bring back logs at all levels.
+	 * The same applies to category filter.
+	 *
+	 * Level filter and category filter are combinational, i.e., only messages
+	 * satisfying both filter conditions will be returned.
+	 *
+	 * @param string level filter
+	 * @param string category filter
+	 * @return array list of messages. Each array elements represents one message
+	 * with the following structure:
+	 * array(
+	 *   [0] => message (string)
+	 *   [1] => level (string)
+	 *   [2] => category (string)
+	 *   [3] => timestamp (float, obtained by microtime(true));
+	 */
+	public function getLogs($levels='',$categories='')
+	{
+		$this->_levels=preg_split('/[\s,]+/',strtolower($levels),-1,PREG_SPLIT_NO_EMPTY);
+		$this->_categories=preg_split('/[\s,]+/',strtolower($categories),-1,PREG_SPLIT_NO_EMPTY);
+		if(empty($levels) && empty($categories))
+			return $this->_logs;
+		else if(empty($levels))
+			return array_values(array_filter(array_filter($this->_logs,array($this,'filterByCategory'))));
+		else if(empty($categories))
+			return array_values(array_filter(array_filter($this->_logs,array($this,'filterByLevel'))));
+		else
+		{
+			$ret=array_values(array_filter(array_filter($this->_logs,array($this,'filterByLevel'))));
+			return array_values(array_filter(array_filter($ret,array($this,'filterByCategory'))));
+		}
+	}
+
+	/**
+	 * Filter function used by {@link getLogs}
+	 * @param array element to be filtered
+	 * @return array valid log, false if not.
+	 */
+	private function filterByCategory($value)
+	{
+		foreach($this->_categories as $category)
+		{
+			$cat=strtolower($value[2]);
+			if($cat===$category || (($c=rtrim($category,'.*'))!==$category && strpos($cat,$c)===0))
+				return $value;
+		}
+		return false;
+	}
+
+	/**
+	 * Filter function used by {@link getLogs}
+	 * @param array element to be filtered
+	 * @return array valid log, false if not.
+	 */
+	private function filterByLevel($value)
+	{
+		return in_array(strtolower($value[1]),$this->_levels)?$value:false;
+	}
+
+	/**
+	 * Returns the total time for serving the current request.
+	 * This method calculates the difference between now and the timestamp
+	 * defined by constant YII_BEGIN_TIME.
+	 * To estimate the execution time more accurately, the constant should
+	 * be defined as early as possible (best at the beginning of the entry script.)
+	 * @return float the total time for serving the current request.
+	 */
+	public function getExecutionTime()
+	{
+		return microtime(true)-YII_BEGIN_TIME;
+	}
+
+	/**
+	 * Returns the memory usage of the current application.
+	 * This method relies on the PHP function memory_get_usage().
+	 * If it is not available, the method will attempt to use OS programs
+	 * to determine the memory usage. A value 0 will be returned if the
+	 * memory usage can still not be determined.
+	 * @return integer memory usage of the application (in bytes).
+	 */
+	public function getMemoryUsage()
+	{
+		if(function_exists('memory_get_usage'))
+			return memory_get_usage();
+		else
+		{
+			$output=array();
+			if(strncmp(PHP_OS,'WIN',3)===0)
+			{
+				exec('tasklist /FI "PID eq ' . getmypid() . '" /FO LIST',$output);
+				return isset($output[5])?preg_replace('/[\D]/','',$output[5])*1024 : 0;
+			}
+			else
+			{
+				$pid=getmypid();
+				exec("ps -eo%mem,rss,pid | grep $pid", $output);
+				$output=explode("  ",$output[0]);
+				return isset($output[1]) ? $output[1]*1024 : 0;
+			}
+		}
+	}
+
+	/**
+	 * Returns the profiling results.
+	 * The results may be filtered by token and/or category.
+	 * If no filter is specified, the returned results would be an array with each element
+	 * being array($token,$category,$time).
+	 * If a filter is specified, the results would be an array of timings.
+	 * @param string token filter. Defaults to null, meaning not filtered by token.
+	 * @param string category filter. Defaults to null, meaning not filtered by category.
+	 * @param boolean whether to refresh the internal timing calculations. If false,
+	 * only the first time calling this method will the timings be calculated internally.
+	 * @return array the profiling results.
+	 * @since 1.0.6
+	 */
+	public function getProfilingResults($token=null,$category=null,$refresh=false)
+	{
+		if($this->_timings===null || $refresh)
+			$this->calculateTimings();
+		if($token===null && $category===null)
+			return $this->_timings;
+		$results=array();
+		foreach($this->_timings as $timing)
+		{
+			if(($category===null || $timing[1]===$category) && ($token===null || $timing[0]===$token))
+				$results[]=$timing[2];
+		}
+		return $results;
+	}
+
+	private function calculateTimings()
+	{
+		$this->_timings=array();
+
+		$stack=array();
+		foreach($this->_logs as $log)
+		{
+			if($log[1]!==CLogger::LEVEL_PROFILE)
+				continue;
+			list($message,$level,$category,$timestamp)=$log;
+			if(!strncasecmp($message,'begin:',6))
+			{
+				$log[0]=substr($message,6);
+				$stack[]=$log;
+			}
+			else if(!strncasecmp($message,'end:',4))
+			{
+				$token=substr($message,4);
+				if(($last=array_pop($stack))!==null && $last[0]===$token)
+				{
+					$delta=$log[3]-$last[3];
+					$this->_timings[]=array($message,$category,$delta);
+				}
+				else
+					throw new CException(Yii::t('yii','CProfileLogRoute found a mismatching code block "{token}". Make sure the calls to Yii::beginProfile() and Yii::endProfile() be properly nested.',
+						array('{token}'=>$token)));
+			}
+		}
+
+		$now=microtime(true);
+		while(($last=array_pop($stack))!==null)
+		{
+			$delta=$now-$last[3];
+			$this->_timings[]=array($last[0],$last[2],$delta);
+		}
+	}
+}

package/pto/yaamp/web/framework-1.0.8/logging/CProfileLogRoute.php

@@ -0,0 +1,201 @@
+<?php
+/**
+ * CProfileLogRoute class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CProfileLogRoute displays the profiling results in Web page.
+ *
+ * The profiling is done by calling {@link YiiBase::beginProfile()} and {@link YiiBase::endProfile()},
+ * which marks the begin and end of a code block.
+ *
+ * CProfileLogRoute supports two types of report by setting the {@link setReport report} property:
+ * <ul>
+ * <li>summary: list the execution time of every marked code block</li>
+ * <li>callstack: list the mark code blocks in a hierarchical view reflecting their calling sequence.</li>
+ * </ul>
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CProfileLogRoute.php 1043 2009-05-21 20:09:27Z qiang.xue $
+ * @package system.logging
+ * @since 1.0
+ */
+class CProfileLogRoute extends CWebLogRoute
+{
+	/**
+	 * @var boolean whether to aggregate results according to profiling tokens.
+	 * If false, the results will be aggregated by categories.
+	 * Defaults to true. Note that this property only affects the summary report
+	 * that is enabled when {@link report} is 'summary'.
+	 * @since 1.0.6
+	 */
+	public $groupByToken=true;
+	/**
+	 * @var string type of profiling report to display
+	 */
+	private $_report='summary';
+
+	/**
+	 * Initializes the route.
+	 * This method is invoked after the route is created by the route manager.
+	 */
+	public function init()
+	{
+		$this->levels=CLogger::LEVEL_PROFILE;
+	}
+
+	/**
+	 * @return string the type of the profiling report to display. Defaults to 'summary'.
+	 */
+	public function getReport()
+	{
+		return $this->_report;
+	}
+
+	/**
+	 * @param string the type of the profiling report to display. Valid values include 'summary' and 'callstack'.
+	 */
+	public function setReport($value)
+	{
+		if($value==='summary' || $value==='callstack')
+			$this->_report=$value;
+		else
+			throw new CException(Yii::t('yii','CProfileLogRoute.report "{report}" is invalid. Valid values include "summary" and "callstack".',
+				array('{report}'=>$value)));
+	}
+
+	/**
+	 * Displays the log messages.
+	 * @param array list of log messages
+	 */
+	public function processLogs($logs)
+	{
+		$app=Yii::app();
+		if(!($app instanceof CWebApplication) || $app->getRequest()->getIsAjaxRequest())
+			return;
+
+		if($this->getReport()==='summary')
+			$this->displaySummary($logs);
+		else
+			$this->displayCallstack($logs);
+	}
+
+	/**
+	 * Displays the callstack of the profiling procedures for display.
+	 * @param array list of logs
+	 */
+	protected function displayCallstack($logs)
+	{
+		$stack=array();
+		$level=0;
+		$results=array();
+		$n=0;
+		foreach($logs as $log)
+		{
+			if($log[1]!==CLogger::LEVEL_PROFILE)
+				continue;
+			$message=$log[0];
+			if(!strncasecmp($message,'begin:',6))
+			{
+				$log[0]=substr($message,6);
+				$log[4]=$n;
+				$stack[]=$log;
+				$n++;
+			}
+			else if(!strncasecmp($message,'end:',4))
+			{
+				$token=substr($message,4);
+				if(($last=array_pop($stack))!==null && $last[0]===$token)
+				{
+					$delta=$log[3]-$last[3];
+					$results[$last[4]]=array($token,$delta,count($stack));
+				}
+				else
+					throw new CException(Yii::t('yii','CProfileLogRoute found a mismatching code block "{token}". Make sure the calls to Yii::beginProfile() and Yii::endProfile() be properly nested.',
+						array('{token}'=>$token)));
+			}
+		}
+		// remaining entries should be closed here
+		$now=microtime(true);
+		while(($last=array_pop($stack))!==null)
+			$results[$last[4]]=array($last[0],$now-$last[3],count($stack));
+		ksort($results);
+		$this->render('profile-callstack',$results);
+	}
+
+	/**
+	 * Displays the summary report of the profiling result.
+	 * @param array list of logs
+	 */
+	protected function displaySummary($logs)
+	{
+		$stack=array();
+		foreach($logs as $log)
+		{
+			if($log[1]!==CLogger::LEVEL_PROFILE)
+				continue;
+			$message=$log[0];
+			if(!strncasecmp($message,'begin:',6))
+			{
+				$log[0]=substr($message,6);
+				$stack[]=$log;
+			}
+			else if(!strncasecmp($message,'end:',4))
+			{
+				$token=substr($message,4);
+				if(($last=array_pop($stack))!==null && $last[0]===$token)
+				{
+					$delta=$log[3]-$last[3];
+					if(!$this->groupByToken)
+						$token=$log[2];
+					if(isset($results[$token]))
+						$results[$token]=$this->aggregateResult($results[$token],$delta);
+					else
+						$results[$token]=array($token,1,$delta,$delta,$delta);
+				}
+				else
+					throw new CException(Yii::t('yii','CProfileLogRoute found a mismatching code block "{token}". Make sure the calls to Yii::beginProfile() and Yii::endProfile() be properly nested.',
+						array('{token}'=>$token)));
+			}
+		}
+
+		$now=microtime(true);
+		while(($last=array_pop($stack))!==null)
+		{
+			$delta=$now-$last[3];
+			$token=$this->groupByToken ? $last[0] : $last[2];
+			if(isset($results[$token]))
+				$results[$token]=$this->aggregateResult($results[$token],$delta);
+			else
+				$results[$token]=array($token,1,$delta,$delta,$delta);
+		}
+
+		$entries=array_values($results);
+		$func=create_function('$a,$b','return $a[4]<$b[4]?1:0;');
+		usort($entries,$func);
+
+		$this->render('profile-summary',$entries);
+	}
+
+	/**
+	 * Aggregates the report result.
+	 * @param array log result for this code block
+	 * @param float time spent for this code block
+	 */
+	protected function aggregateResult($result,$delta)
+	{
+		list($token,$calls,$min,$max,$total)=$result;
+		if($delta<$min)
+			$min=$delta;
+		else if($delta>$max)
+			$max=$delta;
+		$calls++;
+		$total+=$delta;
+		return array($token,$calls,$min,$max,$total);
+	}
+}

package/pto/yaamp/web/framework-1.0.8/logging/CWebLogRoute.php

@@ -0,0 +1,57 @@
+<?php
+/**
+ * CWebLogRoute class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CWebLogRoute shows the log content in Web page.
+ *
+ * The log content can appear either at the end of the current Web page
+ * or in FireBug console window (if {@link showInFireBug} is set true).
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CWebLogRoute.php 639 2009-02-08 16:16:26Z qiang.xue $
+ * @package system.logging
+ * @since 1.0
+ */
+class CWebLogRoute extends CLogRoute
+{
+	/**
+	 * @var boolean whether the log should be displayed in FireBug instead of browser window. Defaults to false.
+	 */
+	public $showInFireBug=false;
+
+	/**
+	 * Displays the log messages.
+	 * @param array list of log messages
+	 */
+	public function processLogs($logs)
+	{
+		$this->render('log',$logs);
+	}
+
+	/**
+	 * Renders the view.
+	 * @param string the view name (file name without extension). The file is assumed to be located under framework/data/views.
+	 * @param array data to be passed to the view
+	 */
+	protected function render($view,$data)
+	{
+		if($this->showInFireBug)
+			$view.='-firebug';
+		else
+		{
+			$app=Yii::app();
+			if(!($app instanceof CWebApplication) || $app->getRequest()->getIsAjaxRequest())
+				return;
+		}
+		$viewFile=YII_PATH.DIRECTORY_SEPARATOR.'views'.DIRECTORY_SEPARATOR.$view.'.php';
+		include(Yii::app()->findLocalizedFile($viewFile,'en'));
+	}
+}
+