powerdlz23 1.1.6 → 1.1.8

package/pto/yaamp/web/framework-1.0.8/utils/CFileHelper.php

@@ -0,0 +1,228 @@
+<?php
+/**
+ * CFileHelper 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/
+ */
+
+/**
+ * CFileHelper provides a set of helper methods for common file system operations.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CFileHelper.php 1246 2009-07-15 18:39:18Z qiang.xue $
+ * @package system.utils
+ * @since 1.0
+ */
+class CFileHelper
+{
+	/**
+	 * Copies a directory recursively as another.
+	 * If the destination directory does not exist, it will be created.
+	 * @param string the source directory
+	 * @param string the destination directory
+	 * @param array options for directory copy. Valid options are:
+	 * <ul>
+	 * <li>fileTypes: array, list of file name suffix (without dot). Only files with these suffixes will be copied.</li>
+	 * <li>exclude: array, list of directory and file exclusions. Each exclusion can be either a name or a path.
+	 * If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of
+	 * '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude
+	 * file or directory '$src/a/b'.</li>
+	 * <li>level: integer, recursion depth, default=-1.
+	 * Level -1 means copying all directories and files under the directory;
+	 * Level 0 means copying only the files DIRECTLY under the directory;
+	 * level N means copying those directories that are within N levels.
+ 	 * </li>
+	 * </ul>
+	 */
+	public static function copyDirectory($src,$dst,$options=array())
+	{
+		$fileTypes=array();
+		$exclude=array();
+		$level=-1;
+		extract($options);
+		self::copyDirectoryRecursive($src,$dst,'',$fileTypes,$exclude,$level);
+	}
+
+	/**
+	 * Returns the files found under the specified directory and subdirectories.
+	 * @param string the directory under which the files will be looked for
+	 * @param array options for file searching. Valid options are:
+	 * <ul>
+	 * <li>fileTypes: array, list of file name suffix (without dot). Only files with these suffixes will be returned.</li>
+	 * <li>exclude: array, list of directory and file exclusions. Each exclusion can be either a name or a path.
+	 * If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of
+	 * '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude
+	 * file or directory '$src/a/b'.</li>
+	 * <li>level: integer, recursion depth, default=-1.
+	 * Level -1 means searching for all directories and files under the directory;
+	 * Level 0 means searching for only the files DIRECTLY under the directory;
+	 * level N means searching for those directories that are within N levels.
+ 	 * </li>
+	 * </ul>
+	 * @return array files found under the directory. The file list is sorted.
+	 */
+	public static function findFiles($dir,$options=array())
+	{
+		$fileTypes=array();
+		$exclude=array();
+		$level=-1;
+		extract($options);
+		$list=self::findFilesRecursive($dir,'',$fileTypes,$exclude,$level);
+		sort($list);
+		return $list;
+	}
+
+	/**
+	 * Copies a directory.
+	 * This method is mainly used by {@link copyDirectory}.
+	 * @param string the source directory
+	 * @param string the destination directory
+	 * @param string the path relative to the original source directory
+	 * @param array list of file name suffix (without dot). Only files with these suffixes will be copied.
+	 * @param array list of directory and file exclusions. Each exclusion can be either a name or a path.
+	 * If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of
+	 * '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude
+	 * file or directory '$src/a/b'.
+	 * @param integer recursion depth. It defaults to -1.
+	 * Level -1 means copying all directories and files under the directory;
+	 * Level 0 means copying only the files DIRECTLY under the directory;
+	 * level N means copying those directories that are within N levels.
+	 */
+	protected static function copyDirectoryRecursive($src,$dst,$base,$fileTypes,$exclude,$level)
+	{
+		@mkdir($dst);
+		@chmod($dst,0777);
+		$folder=opendir($src);
+		while($file=readdir($folder))
+		{
+			if($file==='.' || $file==='..')
+				continue;
+			$path=$src.DIRECTORY_SEPARATOR.$file;
+			$isFile=is_file($path);
+			if(self::validatePath($base,$file,$isFile,$fileTypes,$exclude))
+			{
+				if($isFile)
+					copy($path,$dst.DIRECTORY_SEPARATOR.$file);
+				else if($level)
+					self::copyDirectoryRecursive($path,$dst.DIRECTORY_SEPARATOR.$file,$base.'/'.$file,$fileTypes,$exclude,$level-1);
+			}
+		}
+		closedir($folder);
+	}
+
+	/**
+	 * Returns the files found under the specified directory and subdirectories.
+	 * This method is mainly used by {@link findFiles}.
+	 * @param string the source directory
+	 * @param string the path relative to the original source directory
+	 * @param array list of file name suffix (without dot). Only files with these suffixes will be returned.
+	 * @param array list of directory and file exclusions. Each exclusion can be either a name or a path.
+	 * If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of
+	 * '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude
+	 * file or directory '$src/a/b'.
+	 * @param integer recursion depth. It defaults to -1.
+	 * Level -1 means searching for all directories and files under the directory;
+	 * Level 0 means searching for only the files DIRECTLY under the directory;
+	 * level N means searching for those directories that are within N levels.
+	 * @return array files found under the directory.
+	 */
+	protected static function findFilesRecursive($dir,$base,$fileTypes,$exclude,$level)
+	{
+		$list=array();
+		$handle=opendir($dir);
+		while($file=readdir($handle))
+		{
+			if($file==='.' || $file==='..')
+				continue;
+			$path=$dir.DIRECTORY_SEPARATOR.$file;
+			$isFile=is_file($path);
+			if(self::validatePath($base,$file,$isFile,$fileTypes,$exclude))
+			{
+				if($isFile)
+					$list[]=$path;
+				else if($level)
+					$list=array_merge($list,self::findFilesRecursive($path,$base.'/'.$file,$fileTypes,$exclude,$level-1));
+			}
+		}
+		closedir($handle);
+		return $list;
+	}
+
+	/**
+	 * Validates a file or directory.
+	 * @param string the path relative to the original source directory
+	 * @param string the file or directory name
+	 * @param boolean whether this is a file
+	 * @param array list of file name suffix (without dot). Only files with these suffixes will be copied.
+	 * @param array list of directory and file exclusions. Each exclusion can be either a name or a path.
+	 * If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of
+	 * '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude
+	 * file or directory '$src/a/b'.
+	 * @return boolean whether the file or directory is valid
+	 */
+	protected static function validatePath($base,$file,$isFile,$fileTypes,$exclude)
+	{
+		foreach($exclude as $e)
+		{
+			if($file===$e || strpos($base.'/'.$file,$e)===0)
+				return false;
+		}
+		if(!$isFile || empty($fileTypes))
+			return true;
+		if(($pos=strrpos($file,'.'))!==false)
+		{
+			$type=substr($file,$pos+1);
+			return in_array($type,$fileTypes);
+		}
+		else
+			return false;
+	}
+
+	/**
+	 * Determines the MIME type of the specified file.
+	 * This method will attempt the following approaches in order:
+	 * <ol>
+	 * <li>finfo</li>
+	 * <li>mime_content_type</li>
+	 * <li>{@link getMimeTypeByExtension}</li>
+	 * </ol>
+	 * @param string the file name.
+	 * @return string the MIME type. Null is returned if the MIME type cannot be determined.
+	 */
+	public static function getMimeType($file)
+	{
+		if(function_exists('finfo_open'))
+		{
+			if(($info=finfo_open(FILEINFO_MIME)) && ($result=finfo_file($info,$file))!==false)
+				return $result;
+		}
+
+		if(function_exists('mime_content_type') && ($result=mime_content_type($file))!==false)
+			return $result;
+
+		return self::getMimeTypeByExtension($file);
+	}
+
+	/**
+	 * Determines the MIME type based on the extension name of the specified file.
+	 * This method will use a local map between extension name and MIME type.
+	 * @param string the file name.
+	 * @return string the MIME type. Null is returned if the MIME type cannot be determined.
+	 */
+	public static function getMimeTypeByExtension($file)
+	{
+		static $extensions;
+		if($extensions===null)
+			$extensions=require(Yii::getPathOfAlias('system.utils.mimeTypes').'.php');
+		if(($pos=strrpos($file,'.'))!==false)
+		{
+			$ext=strtolower(substr($file,$pos+1));
+			if(isset($extensions[$ext]))
+				return $extensions[$ext];
+		}
+		return null;
+	}
+}

package/pto/yaamp/web/framework-1.0.8/utils/CMarkdownParser.php

@@ -0,0 +1,179 @@
+<?php
+/**
+ * CMarkdownParser 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/
+ */
+
+require_once(Yii::getPathOfAlias('system.vendors.markdown.markdown').'.php');
+
+/**
+ * CMarkdownParser is a wrapper of {@link http://michelf.com/projects/php-markdown/extra/ MarkdownExtra_Parser}.
+ *
+ * CMarkdownParser extends MarkdownExtra_Parser by using Text_Highlighter
+ * to highlight code blocks with specific language syntax.
+ * In particular, if a code block starts with the following:
+ * <pre>
+ * [language]
+ * </pre>
+ * The syntax for the specified language will be used to highlight
+ * code block. The languages supported include (case-insensitive):
+ * ABAP, CPP, CSS, DIFF, DTD, HTML, JAVA, JAVASCRIPT,
+ * MYSQL, PERL, PHP, PYTHON, RUBY, SQL, XML
+ *
+ * You can also specify options to be passed to the syntax highlighter. For example:
+ * <pre>
+ * [php showLineNumbers=1]
+ * </pre>
+ * which will show line numbers in each line of the code block.
+ *
+ * For details about the standard markdown syntax, please check the following:
+ * <ul>
+ * <li>{@link http://daringfireball.net/projects/markdown/syntax official markdown syntax}</li>
+ * <li>{@link http://michelf.com/projects/php-markdown/extra/ markdown extra syntax}</li>
+ * </ul>
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CMarkdownParser.php 443 2009-01-01 23:11:39Z qiang.xue $
+ * @package system.utils
+ * @since 1.0
+ */
+class CMarkdownParser extends MarkdownExtra_Parser
+{
+	/**
+	 * @var string the css class for the div element containing
+	 * the code block that is highlighted. Defaults to 'hl-code'.
+	 */
+	public $highlightCssClass='hl-code';
+
+	/**
+	 * Transforms the content and purifies the result.
+	 * This method calls the transform() method to convert
+	 * markdown content into HTML content. It then
+	 * uses {@link CHtmlPurifier} to purify the HTML content
+	 * to avoid XSS attacks.
+	 * @param string the markdown content
+	 * @return string the purified HTML content
+	 * @since 1.0.1
+	 */
+	public function safeTransform($content)
+	{
+		$content=$this->transform($content);
+		$purifier=new CHtmlPurifier;
+		return $purifier->purify($content);
+	}
+
+	/**
+	 * @return string the default CSS file that is used to highlight code blocks.
+	 */
+	public function getDefaultCssFile()
+	{
+		return Yii::getPathOfAlias('system.vendors.TextHighlighter.highlight').'.css';
+	}
+
+	/**
+	 * Callback function when a code block is matched.
+	 * @param array matches
+	 * @return string the highlighted code block
+	 */
+	public function _doCodeBlocks_callback($matches)
+	{
+		$codeblock = $this->outdent($matches[1]);
+		if(($codeblock = $this->highlightCodeBlock($codeblock)) !== null)
+			return "\n\n".$this->hashBlock($codeblock)."\n\n";
+		else
+			return parent::_doCodeBlocks_callback($matches);
+	}
+
+	/**
+	 * Callback function when a fenced code block is matched.
+	 * @param array matches
+	 * @return string the highlighted code block
+	 */
+	public function _doFencedCodeBlocks_callback($matches)
+	{
+		return "\n\n".$this->hashBlock($this->highlightCodeBlock($matches[2]))."\n\n";
+	}
+
+	/**
+	 * Highlights the code block.
+	 * @param string the code block
+	 * @return string the highlighted code block. Null if the code block does not need to highlighted
+	 */
+	protected function highlightCodeBlock($codeblock)
+	{
+		if(($tag=$this->getHighlightTag($codeblock))!==null && ($highlighter=$this->createHighLighter($tag)))
+		{
+			$codeblock = preg_replace('/\A\n+|\n+\z/', '', $codeblock);
+			$tagLen = strpos($codeblock, $tag)+strlen($tag);
+			$codeblock = ltrim(substr($codeblock, $tagLen));
+			$output=preg_replace('/<span\s+[^>]*>(\s*)<\/span>/', '\1', $highlighter->highlight($codeblock));
+			return "<div class=\"{$this->highlightCssClass}\">".$output."</div>";
+		}
+		else
+			return "<pre>".$codeblock."</pre>";
+	}
+
+	/**
+	 * Returns the user-entered highlighting options.
+	 * @param string code block with highlighting options.
+	 * @return string the user-entered highlighting options. Null if no option is entered.
+	 */
+	protected function getHighlightTag($codeblock)
+	{
+		$str = trim(current(preg_split("/\r|\n/", $codeblock,2)));
+		if(strlen($str) > 2 && $str[0] === '[' && $str[strlen($str)-1] === ']')
+			return $str;
+	}
+
+	/**
+	 * Creates a highlighter instance.
+	 * @param string the user-entered options
+	 * @return Text_Highlighter the highlighter instance
+	 */
+	protected function createHighLighter($options)
+	{
+		if(!class_exists('Text_Highlighter', false))
+		{
+			require_once(Yii::getPathOfAlias('system.vendors.TextHighlighter.Text.Highlighter').'.php');
+			require_once(Yii::getPathOfAlias('system.vendors.TextHighlighter.Text.Highlighter.Renderer.Html').'.php');
+		}
+		$lang = current(preg_split('/\s+/', substr(substr($options,1), 0,-1),2));
+		$highlighter = Text_Highlighter::factory($lang);
+		if($highlighter)
+			$highlighter->setRenderer(new Text_Highlighter_Renderer_Html($this->getHiglightConfig($options)));
+		return $highlighter;
+	}
+
+	/**
+	 * Generates the config for the highlighter.
+	 * @param string user-entered options
+	 * @return array the highlighter config
+	 */
+	public function getHiglightConfig($options)
+	{
+		$config['use_language'] = true;
+		if( $this->getInlineOption('showLineNumbers', $options, false) )
+			$config['numbers'] = HL_NUMBERS_LI;
+		$config['tabsize'] = $this->getInlineOption('tabSize', $options, 4);
+		return $config;
+	}
+
+	/**
+	 * Retrieves the specified configuration.
+	 * @param string the configuration name
+	 * @param string the user-entered options
+	 * @param mixed default value if the configuration is not present
+	 * @return mixed the configuration value
+	 */
+	protected function getInlineOption($name, $str, $defaultValue)
+	{
+		if(preg_match('/'.$name.'(\s*=\s*(\d+))?/i', $str, $v) && count($v) > 2)
+			return $v[2];
+		else
+			return $defaultValue;
+	}
+}

package/pto/yaamp/web/framework-1.0.8/utils/CPropertyValue.php

@@ -0,0 +1,158 @@
+<?php
+/**
+ * CPropertyValue 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/
+ */
+
+/**
+ * CPropertyValue is a helper class that provides static methods to convert component property values to specific types.
+ *
+ * CPropertyValue is commonly used in component setter methods to ensure
+ * the new property value is of the specific type.
+ * For example, a boolean-typed property setter method would be as follows,
+ * <pre>
+ * public function setPropertyName($value)
+ * {
+ *     $value=CPropertyValue::ensureBoolean($value);
+ *     // $value is now of boolean type
+ * }
+ * </pre>
+ *
+ * Properties can be of the following types with specific type conversion rules:
+ * <ul>
+ * <li>string: a boolean value will be converted to 'true' or 'false'.</li>
+ * <li>boolean: string 'true' (case-insensitive) will be converted to true,
+ *            string 'false' (case-insensitive) will be converted to false.</li>
+ * <li>integer</li>
+ * <li>float</li>
+ * <li>array: string starting with '(' and ending with ')' will be considered as
+ *          as an array expression and will be evaluated. Otherwise, an array
+ *          with the value to be ensured is returned.</li>
+ * <li>object</li>
+ * <li>enum: enumerable type, represented by an array of strings.</li>
+ * </ul>
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CPropertyValue.php 568 2009-01-23 22:50:14Z qiang.xue $
+ * @package system.utils
+ * @since 1.0
+ */
+class CPropertyValue
+{
+	/**
+	 * Converts a value to boolean type.
+	 * Note, string 'true' (case-insensitive) will be converted to true,
+	 * string 'false' (case-insensitive) will be converted to false.
+	 * If a string represents a non-zero number, it will be treated as true.
+	 * @param mixed the value to be converted.
+	 * @return boolean
+	 */
+	public static function ensureBoolean($value)
+	{
+		if (is_string($value))
+			return !strcasecmp($value,'true') || $value!=0;
+		else
+			return (boolean)$value;
+	}
+
+	/**
+	 * Converts a value to string type.
+	 * Note, a boolean value will be converted to 'true' if it is true
+	 * and 'false' if it is false.
+	 * @param mixed the value to be converted.
+	 * @return string
+	 */
+	public static function ensureString($value)
+	{
+		if (is_bool($value))
+			return $value?'true':'false';
+		else
+			return (string)$value;
+	}
+
+	/**
+	 * Converts a value to integer type.
+	 * @param mixed the value to be converted.
+	 * @return integer
+	 */
+	public static function ensureInteger($value)
+	{
+		return (integer)$value;
+	}
+
+	/**
+	 * Converts a value to float type.
+	 * @param mixed the value to be converted.
+	 * @return float
+	 */
+	public static function ensureFloat($value)
+	{
+		return (float)$value;
+	}
+
+	/**
+	 * Converts a value to array type. If the value is a string and it is
+	 * in the form (a,b,c) then an array consisting of each of the elements
+	 * will be returned. If the value is a string and it is not in this form
+	 * then an array consisting of just the string will be returned. If the value
+	 * is not a string then
+	 * @param mixed the value to be converted.
+	 * @return array
+	 */
+	public static function ensureArray($value)
+	{
+		if(is_string($value))
+		{
+			$value = trim($value);
+			$len = strlen($value);
+			if ($len >= 2 && $value[0] == '(' && $value[$len-1] == ')')
+			{
+				eval('$array=array'.$value.';');
+				return $array;
+			}
+			else
+				return $len>0?array($value):array();
+		}
+		else
+			return (array)$value;
+	}
+
+	/**
+	 * Converts a value to object type.
+	 * @param mixed the value to be converted.
+	 * @return object
+	 */
+	public static function ensureObject($value)
+	{
+		return (object)$value;
+	}
+
+	/**
+	 * Converts a value to enum type.
+	 *
+	 * This method checks if the value is of the specified enumerable type.
+	 * A value is a valid enumerable value if it is equal to the name of a constant
+	 * in the specified enumerable type (class).
+	 * For more details about enumerable, see {@link CEnumerable}.
+	 *
+	 * @param string the enumerable value to be checked.
+	 * @param string the enumerable class name (make sure it is included before calling this function).
+	 * @return string the valid enumeration value
+	 * @throws CException if the value is not a valid enumerable value
+	 */
+	public static function ensureEnum($value,$enumType)
+	{
+		static $types=array();
+		if(!isset($types[$enumType]))
+			$types[$enumType]=new ReflectionClass($enumType);
+		if($types[$enumType]->hasConstant($value))
+			return $value;
+		else
+			throw new CException(Yii::t('yii','Invalid enumerable value "{value}". Please make sure it is among ({enum}).',
+				array('{value}'=>$value, '{enum}'=>implode(', ',$types[$enumType]->getConstants()))));
+	}
+}