powerdlz23 1.1.7 → 1.1.9

package/pto/yaamp/web/framework-1.0.8/validators/CExistValidator.php

@@ -0,0 +1,88 @@
+<?php
+/**
+ * CExistValidator 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/
+ */
+
+/**
+ * CExistValidator validates that the attribute value exists in a table.
+ *
+ * This validator is often used to verify that a foreign key contains a value
+ * that can be found in the foreign table.
+ *
+ * CExistValidator can only be used for active record objects.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CExistValidator.php 1268 2009-07-22 15:37:50Z qiang.xue $
+ * @package system.validators
+ * @since 1.0.4
+ */
+class CExistValidator extends CValidator
+{
+	/**
+	 * @var string the ActiveRecord class name that should be used to
+	 * look for the attribute value being validated. Defaults to null,
+	 * meaning using the ActiveRecord class of the attribute being validated.
+	 * You may use path alias to reference a class name here.
+	 * @see attributeName
+	 */
+	public $className;
+	/**
+	 * @var string the ActiveRecord class attribute name that should be
+	 * used to look for the attribute value being validated. Defaults to null,
+	 * meaning using the name of the attribute being validated.
+	 * @see className
+	 */
+	public $attributeName;
+	/**
+	 * @var array additional query criteria. This will be combined with the condition
+	 * that checks if the attribute value exists in the corresponding table column.
+	 * This array will be used to instantiate a {@link CDbCriteria} object.
+	 * @since 1.0.8
+	 */
+	public $criteria=array();
+	/**
+	 * @var boolean whether the attribute value can be null or empty. Defaults to true,
+	 * meaning that if the attribute is empty, it is considered valid.
+	 */
+	public $allowEmpty=true;
+
+	/**
+	 * Validates the attribute of the object.
+	 * If there is any error, the error message is added to the object.
+	 * @param CModel the object being validated
+	 * @param string the attribute being validated
+	 */
+	protected function validateAttribute($object,$attribute)
+	{
+		$value=$object->$attribute;
+		if($this->allowEmpty && ($value===null || $value===''))
+			return;
+
+		$className=$this->className===null?get_class($object):Yii::import($this->className);
+		$attributeName=$this->attributeName===null?$attribute:$this->attributeName;
+		$finder=CActiveRecord::model($className);
+		$table=$finder->getTableSchema();
+		if(($column=$table->getColumn($attributeName))===null)
+			throw new CException(Yii::t('yii','Column "{column} does not exist in table "{table}".',
+				array('{column}'=>$attributeName,'{table}'=>$table->name)));
+
+		$criteria=array('condition'=>$column->rawName.'=:vp','params'=>array(':vp'=>$value));
+		if($this->criteria!==array())
+		{
+			$criteria=new CDbCriteria($criteria);
+			$criteria->mergeWith($this->criteria);
+		}
+
+		if(!$finder->exists($criteria))
+		{
+			$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} "{value}" is invalid.');
+			$this->addError($object,$attribute,$message,array('{value}'=>$value));
+		}
+	}
+}
+

package/pto/yaamp/web/framework-1.0.8/validators/CFileValidator.php

@@ -0,0 +1,159 @@
+<?php
+/**
+ * CFileValidator 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/
+ */
+
+/**
+ * CFileValidator verifies if an attribute is receiving a valid uploaded file.
+ *
+ * It uses the model class and attribute name to retrieve the information
+ * about the uploaded file. It then checks if a file is uploaded successfully,
+ * if the file size is within the limit and if the file type is allowed.
+ *
+ * When using CFileValidator with an active record, the following code is often used:
+ * <pre>
+ *  // assuming the upload file field is generated using
+ *  // CHtml::activeFileField($model,'file');
+ *  $model->file=CUploadedFile::getInstance($model,'file');
+ *  $model->fileSize=$file->size;
+ *  if($model->save())
+ *      $model->file->saveAs($path); // save the uploaded file
+ * </pre>
+ *
+ * You can use {@link CFileValidator} to validate the file attribute.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CFileValidator.php 1271 2009-07-22 20:25:46Z qiang.xue $
+ * @package system.validators
+ * @since 1.0
+ */
+class CFileValidator extends CValidator
+{
+	/**
+	 * @var boolean whether the attribute requires a file to be uploaded or not.
+	 * Defaults to false, meaning a file is required to be uploaded.
+	 */
+	public $allowEmpty=false;
+	/**
+	 * @var mixed a list of file name extensions that are allowed to be uploaded.
+	 * This can be either an array or a string consisting of file extension names
+	 * separated by space or comma (e.g. "gif, jpg").
+	 * Extension names are case-insensitive. Defaults to null, meaning all file name
+	 * extensions are allowed.
+	 */
+	public $types;
+	/**
+	 * @var integer the minimum number of bytes required for the uploaded file.
+	 * Defaults to null, meaning no limit.
+	 * @see tooSmall
+	 */
+	public $minSize;
+	/**
+	 * @var integer the maximum number of bytes required for the uploaded file.
+	 * Defaults to null, meaning no limit.
+	 * Note, the size limit is also affected by 'upload_max_filesize' INI setting
+	 * and the 'MAX_FILE_SIZE' hidden field value.
+	 * @see tooLarge
+	 */
+	public $maxSize;
+	/**
+	 * @var string the error message used when the uploaded file is too large.
+	 * @see maxSize
+	 */
+	public $tooLarge;
+	/**
+	 * @var string the error message used when the uploaded file is too small.
+	 * @see minSize
+	 */
+	public $tooSmall;
+	/**
+	 * @var string the error message used when the uploaded file has an extension name
+	 * that is not listed among {@link extensions}.
+	 */
+	public $wrongType;
+
+	/**
+	 * Validates the attribute of the object.
+	 * If there is any error, the error message is added to the object.
+	 * @param CModel the object being validated
+	 * @param string the attribute being validated
+	 */
+	protected function validateAttribute($object,$attribute)
+	{
+		$file=$object->$attribute;
+		if(!($file instanceof CUploadedFile))
+			$file=CUploadedFile::getInstance($object,$attribute);
+
+		if($this->allowEmpty && ($file===null || $file->getError()==UPLOAD_ERR_NO_FILE))
+			return;
+
+		if($file===null || $file->getError()==UPLOAD_ERR_NO_FILE)
+		{
+			$message=$this->message!==null?$this->message : Yii::t('yii','{attribute} cannot be blank.');
+			$this->addError($object,$attribute,$message);
+			return;
+		}
+
+		$error=$file->getError();
+		if($error==UPLOAD_ERR_INI_SIZE || $error==UPLOAD_ERR_FORM_SIZE || $this->maxSize!==null && $file->getSize()>$this->maxSize)
+		{
+			$message=$this->tooLarge!==null?$this->tooLarge : Yii::t('yii','The file "{file}" is too large. Its size cannot exceed {limit} bytes.');
+			$this->addError($object,$attribute,$message,array('{file}'=>$file->getName(), '{limit}'=>$this->getSizeLimit()));
+		}
+		else if($error==UPLOAD_ERR_PARTIAL)
+			throw new CException(Yii::t('yii','The file "{file}" was only partially uploaded.',array('{file}'=>$file->getName())));
+		else if($error==UPLOAD_ERR_NO_TMP_DIR)
+			throw new CException(Yii::t('yii','Missing the temporary folder to store the uploaded file "{file}".',array('{file}'=>$file->getName())));
+		else if($error==UPLOAD_ERR_CANT_WRITE)
+			throw new CException(Yii::t('yii','Failed to write the uploaded file "{file}" to disk.',array('{file}'=>$file->getName())));
+		else if(defined('UPLOAD_ERR_EXTENSION') && $error==UPLOAD_ERR_EXTENSION)  // available for PHP 5.2.0 or above
+			throw new CException(Yii::t('yii','File upload was stopped by extension.'));
+
+		if($this->minSize!==null && $file->getSize()<$this->minSize)
+		{
+			$message=$this->tooSmall!==null?$this->tooSmall : Yii::t('yii','The file "{file}" is too small. Its size cannot be smaller than {limit} bytes.');
+			$this->addError($object,$attribute,$message,array('{file}'=>$file->getName(), '{limit}'=>$this->minSize));
+		}
+
+		if($this->types!==null)
+		{
+			if(is_string($this->types))
+				$types=preg_split('/[\s,]+/',strtolower($this->types),-1,PREG_SPLIT_NO_EMPTY);
+			else
+				$types=$this->types;
+			if(!in_array(strtolower($file->getExtensionName()),$types))
+			{
+				$message=$this->wrongType!==null?$this->wrongType : Yii::t('yii','The file "{file}" cannot be uploaded. Only files with these extensions are allowed: {extensions}.');
+				$this->addError($object,$attribute,$message,array('{file}'=>$file->getName(), '{extensions}'=>implode(', ',$types)));
+			}
+		}
+	}
+
+	/**
+	 * Returns the maximum size allowed for uploaded files.
+	 * This is determined based on three factors:
+	 * <ul>
+	 * <li>'upload_max_filesize' in php.ini</li>
+	 * <li>'MAX_FILE_SIZE' hidden field</li>
+	 * <li>{@link maxSize}</li>
+	 * </ul>
+	 *
+	 * @return integer the size limit for uploaded files.
+	 */
+	protected function getSizeLimit()
+	{
+		$limit=ini_get('upload_max_filesize');
+		if(strpos($limit,'M')!==false)
+			$limit=$limit*1024*1024;
+		if($this->maxSize!==null && $limit>0 && $this->maxSize<$limit)
+			$limit=$this->maxSize;
+		if(isset($_POST['MAX_FILE_SIZE']) && $_POST['MAX_FILE_SIZE']>0 && $_POST['MAX_FILE_SIZE']<$limit)
+			$limit=$_POST['MAX_FILE_SIZE'];
+		return $limit;
+	}
+}

package/pto/yaamp/web/framework-1.0.8/validators/CFilterValidator.php

@@ -0,0 +1,49 @@
+<?php
+/**
+ * CFilterValidator 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/
+ */
+
+/**
+ * CFilterValidator transforms the data being validated based on a filter.
+ *
+ * CFilterValidator is actually not a validator but a data processor.
+ * It invokes the specified filter method to process the attribute value
+ * and save the processed value back to the attribute. The filter method
+ * must follow the following signature:
+ * <pre>
+ * function foo($value) {...return $newValue; }
+ * </pre>
+ * Many PHP functions qualify this signature (e.g. trim).
+ *
+ * To specify the filter method, set {@link filter} property to be the function name.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CFilterValidator.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.validators
+ * @since 1.0
+ */
+class CFilterValidator extends CValidator
+{
+	/**
+	 * @var callback the filter method
+	 */
+	public $filter;
+
+	/**
+	 * Validates the attribute of the object.
+	 * If there is any error, the error message is added to the object.
+	 * @param CModel the object being validated
+	 * @param string the attribute being validated
+	 */
+	protected function validateAttribute($object,$attribute)
+	{
+		if($this->filter===null || !is_callable($this->filter))
+			throw new CException(Yii::t('yii','The "filter" property must be specified with a valid callback.'));
+		$object->$attribute=call_user_func_array($this->filter,$object->$attribute);
+	}
+}

package/pto/yaamp/web/framework-1.0.8/validators/CInlineValidator.php

@@ -0,0 +1,41 @@
+<?php
+/**
+ * CInlineValidator 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/
+ */
+
+/**
+ * CInlineValidator represents a validator which is defined as a method in the object being validated.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CInlineValidator.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.validators
+ * @since 1.0
+ */
+class CInlineValidator extends CValidator
+{
+	/**
+	 * @var string the name of the validation method defined in the active record class
+	 */
+	public $method;
+	/**
+	 * @var array additional parameters that are passed to the validation method
+	 */
+	public $params;
+
+	/**
+	 * Validates the attribute of the object.
+	 * If there is any error, the error message is added to the object.
+	 * @param CModel the object being validated
+	 * @param string the attribute being validated
+	 */
+	protected function validateAttribute($object,$attribute)
+	{
+		$method=$this->method;
+		$object->$method($attribute,$this->params);
+	}
+}

package/pto/yaamp/web/framework-1.0.8/validators/CNumberValidator.php

@@ -0,0 +1,86 @@
+<?php
+/**
+ * CNumberValidator 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/
+ */
+
+/**
+ * CNumberValidator validates that the attribute value is a number.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CNumberValidator.php 1178 2009-06-26 20:13:31Z qiang.xue $
+ * @package system.validators
+ * @since 1.0
+ */
+class CNumberValidator extends CValidator
+{
+	/**
+	 * @var boolean whether the attribute value can only be an integer. Defaults to false.
+	 */
+	public $integerOnly=false;
+	/**
+	 * @var boolean whether the attribute value can be null or empty. Defaults to true,
+	 * meaning that if the attribute is empty, it is considered valid.
+	 */
+	public $allowEmpty=true;
+	/**
+	 * @var integer|double upper limit of the number. Defaults to null, meaning no upper limit.
+	 */
+	public $max;
+	/**
+	 * @var integer|double lower limit of the number. Defaults to null, meaning no lower limit.
+	 */
+	public $min;
+	/**
+	 * @var string user-defined error message used when the value is too big.
+	 */
+	public $tooBig;
+	/**
+	 * @var string user-defined error message used when the value is too small.
+	 */
+	public $tooSmall;
+
+
+	/**
+	 * Validates the attribute of the object.
+	 * If there is any error, the error message is added to the object.
+	 * @param CModel the object being validated
+	 * @param string the attribute being validated
+	 */
+	protected function validateAttribute($object,$attribute)
+	{
+		$value=$object->$attribute;
+		if($this->allowEmpty && ($value===null || $value===''))
+			return;
+		if($this->integerOnly)
+		{
+			if(is_string($value) && !preg_match('/^\s*[+-]?\d+\s*$/',$value))
+			{
+				$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} must be an integer.');
+				$this->addError($object,$attribute,$message);
+			}
+		}
+		else
+		{
+			if(is_string($value) && !preg_match('/^\s*[-+]?[0-9]*\.?[0-9]+([eE][-+]?[0-9]+)?\s*$/',$value))
+			{
+				$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} must be a number.');
+				$this->addError($object,$attribute,$message);
+			}
+		}
+		if($this->min!==null && $value<$this->min)
+		{
+			$message=$this->tooSmall!==null?$this->tooSmall:Yii::t('yii','{attribute} is too small (minimum is {min}).');
+			$this->addError($object,$attribute,$message,array('{min}'=>$this->min));
+		}
+		if($this->max!==null && $value>$this->max)
+		{
+			$message=$this->tooBig!==null?$this->tooBig:Yii::t('yii','{attribute} is too big (maximum is {max}).');
+			$this->addError($object,$attribute,$message,array('{max}'=>$this->max));
+		}
+	}
+}

package/pto/yaamp/web/framework-1.0.8/validators/CRangeValidator.php

@@ -0,0 +1,53 @@
+<?php
+/**
+ * CRangeValidator 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/
+ */
+
+/**
+ * CRangeValidator validates that the attribute value is among the list (specified via {@link range}).
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CRangeValidator.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.validators
+ * @since 1.0
+ */
+class CRangeValidator extends CValidator
+{
+	/**
+	 * @var array list of valid values that the attribute value should be among
+	 */
+	public $range;
+	/**
+	 * @var boolean whether the comparison is strict (both type and value must be the same)
+	 */
+	public $strict=false;
+	/**
+	 * @var boolean whether the attribute value can be null or empty. Defaults to true,
+	 * meaning that if the attribute is empty, it is considered valid.
+	 */
+	public $allowEmpty=true;
+
+	/**
+	 * Validates the attribute of the object.
+	 * If there is any error, the error message is added to the object.
+	 * @param CModel the object being validated
+	 * @param string the attribute being validated
+	 */
+	protected function validateAttribute($object,$attribute)
+	{
+		$value=$object->$attribute;
+		if($this->allowEmpty && ($value===null || $value===''))
+			return;
+		if(is_array($this->range) && !in_array($value,$this->range,$this->strict))
+		{
+			$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} is not in the list.');
+			$this->addError($object,$attribute,$message);
+		}
+	}
+}
+

package/pto/yaamp/web/framework-1.0.8/validators/CRegularExpressionValidator.php

@@ -0,0 +1,51 @@
+<?php
+/**
+ * CRegularExpressionValidator 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/
+ */
+
+/**
+ * CRegularExpressionValidator validates that the attribute value matches to the specified {@link pattern regular expression}.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CRegularExpressionValidator.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.validators
+ * @since 1.0
+ */
+class CRegularExpressionValidator extends CValidator
+{
+	/**
+	 * @var string the regular expression to be matched with
+	 */
+	public $pattern;
+	/**
+	 * @var boolean whether the attribute value can be null or empty. Defaults to true,
+	 * meaning that if the attribute is empty, it is considered valid.
+	 */
+	public $allowEmpty=true;
+
+	/**
+	 * Validates the attribute of the object.
+	 * If there is any error, the error message is added to the object.
+	 * @param CModel the object being validated
+	 * @param string the attribute being validated
+	 */
+	protected function validateAttribute($object,$attribute)
+	{
+		$value=$object->$attribute;
+		if($this->allowEmpty && ($value===null || $value===''))
+			return;
+		if($this->pattern===null)
+			throw new CException(Yii::t('yii','The "pattern" property must be specified with a valid regular expression.'));
+		if(!preg_match($this->pattern,$value))
+		{
+			$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} is invalid.');
+			$this->addError($object,$attribute,$message);
+		}
+	}
+}
+

package/pto/yaamp/web/framework-1.0.8/validators/CRequiredValidator.php

@@ -0,0 +1,36 @@
+<?php
+/**
+ * CRequiredValidator 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/
+ */
+
+/**
+ * CRequiredValidator validates that the specified attribute does not have null or empty value.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CRequiredValidator.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.validators
+ * @since 1.0
+ */
+class CRequiredValidator extends CValidator
+{
+	/**
+	 * Validates the attribute of the object.
+	 * If there is any error, the error message is added to the object.
+	 * @param CModel the object being validated
+	 * @param string the attribute being validated
+	 */
+	protected function validateAttribute($object,$attribute)
+	{
+		$value=$object->$attribute;
+		if($value===null || trim($value)==='')
+		{
+			$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} cannot be blank.');
+			$this->addError($object,$attribute,$message);
+		}
+	}
+}

package/pto/yaamp/web/framework-1.0.8/validators/CStringValidator.php

@@ -0,0 +1,78 @@
+<?php
+/**
+ * CStringValidator 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/
+ */
+
+/**
+ * CStringValidator validates that the attribute value is of certain length.
+ *
+ * Note, this validator should only be used with string-typed attributes.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CStringValidator.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.validators
+ * @since 1.0
+ */
+class CStringValidator extends CValidator
+{
+	/**
+	 * @var integer maximum length. Defaults to null, meaning no maximum limit.
+	 */
+	public $max;
+	/**
+	 * @var integer minimum length. Defaults to null, meaning no minimum limit.
+	 */
+	public $min;
+	/**
+	 * @var integer exact length. Defaults to null, meaning no exact length limit.
+	 */
+	public $is;
+	/**
+	 * @var string user-defined error message used when the value is too long.
+	 */
+	public $tooShort;
+	/**
+	 * @var string user-defined error message used when the value is too short.
+	 */
+	public $tooLong;
+	/**
+	 * @var boolean whether the attribute value can be null or empty. Defaults to true,
+	 * meaning that if the attribute is empty, it is considered valid.
+	 */
+	public $allowEmpty=true;
+
+	/**
+	 * Validates the attribute of the object.
+	 * If there is any error, the error message is added to the object.
+	 * @param CModel the object being validated
+	 * @param string the attribute being validated
+	 */
+	protected function validateAttribute($object,$attribute)
+	{
+		$value=$object->$attribute;
+		if($this->allowEmpty && ($value===null || $value===''))
+			return;
+		$length=strlen($value);
+		if($this->min!==null && $length<$this->min)
+		{
+			$message=$this->tooShort!==null?$this->tooShort:Yii::t('yii','{attribute} is too short (minimum is {min} characters).');
+			$this->addError($object,$attribute,$message,array('{min}'=>$this->min));
+		}
+		if($this->max!==null && $length>$this->max)
+		{
+			$message=$this->tooLong!==null?$this->tooLong:Yii::t('yii','{attribute} is too long (maximum is {max} characters).');
+			$this->addError($object,$attribute,$message,array('{max}'=>$this->max));
+		}
+		if($this->is!==null && $length!==$this->is)
+		{
+			$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} is of the wrong length (should be {length} characters).');
+			$this->addError($object,$attribute,$message,array('{length}'=>$this->is));
+		}
+	}
+}
+