w

framework/validators/BooleanValidator.php

@@ -2,12 +2,13 @@
 /**
  * CBooleanValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CBooleanValidator validates that the attribute value is either {@link trueValue}  or {@link falseValue}.
  *

framework/validators/CaptchaValidator.php

@@ -2,12 +2,13 @@
 /**
  * CCaptchaValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CCaptchaValidator validates that the attribute value is the same as the verification code displayed in the CAPTCHA.
  *

framework/validators/CompareValidator.php

@@ -2,12 +2,13 @@
 /**
  * CCompareValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CCompareValidator compares the specified attribute value with another value and validates if they are equal.
  *

framework/validators/DateValidator.php

@@ -2,12 +2,13 @@
 /**
  * CDateValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CDateValidator verifies if the attribute represents a date, time or datetime.
  *

framework/validators/DefaultValueValidator.php

@@ -2,12 +2,13 @@
 /**
  * CDefaultValueValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CDefaultValueValidator sets the attributes with the specified value.
  * It does not do validation. Its existence is mainly to allow

framework/validators/EmailValidator.php

@@ -2,12 +2,13 @@
 /**
  * CEmailValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CEmailValidator validates that the attribute value is a valid email address.
  *

framework/validators/ExistValidator.php

@@ -2,12 +2,13 @@
 /**
  * CExistValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CExistValidator validates that the attribute value exists in a table.
  *

framework/validators/FileValidator.php

@@ -2,12 +2,13 @@
 /**
  * CFileValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CFileValidator verifies if an attribute is receiving a valid uploaded file.
  *

framework/validators/FilterValidator.php

@@ -2,12 +2,13 @@
 /**
  * CFilterValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CFilterValidator transforms the data being validated based on a filter.
  *

framework/validators/InlineValidator.php

@@ -2,12 +2,13 @@
 /**
  * CInlineValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CInlineValidator represents a validator which is defined as a method in the object being validated.
  *

framework/validators/NumberValidator.php

@@ -2,12 +2,13 @@
 /**
  * CNumberValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CNumberValidator validates that the attribute value is a number.
  *

framework/validators/RangeValidator.php

@@ -2,12 +2,13 @@
 /**
  * CRangeValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CRangeValidator validates that the attribute value is among the list (specified via {@link range}).
  * You may invert the validation logic with help of the {@link not} property (available since 1.1.5).

framework/validators/RegularExpressionValidator.php

@@ -2,12 +2,13 @@
 /**
  * CRegularExpressionValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CRegularExpressionValidator validates that the attribute value matches to the specified {@link pattern regular expression}.
  * You may invert the validation logic with help of the {@link not} property (available since 1.1.5).

framework/validators/RequiredValidator.php

@@ -2,12 +2,13 @@
 /**
  * CRequiredValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CRequiredValidator validates that the specified attribute does not have null or empty value.
  *

framework/validators/SafeValidator.php

@@ -2,12 +2,13 @@
 /**
  * CSafeValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CSafeValidator marks the associated attributes to be safe for massive assignments.
  *

framework/validators/StringValidator.php

@@ -2,12 +2,13 @@
 /**
  * CStringValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CStringValidator validates that the attribute value is of certain length.
  *

framework/validators/TypeValidator.php

@@ -2,12 +2,13 @@
 /**
  * CTypeValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CTypeValidator verifies if the attribute is of the type specified by {@link type}.
  *

framework/validators/UniqueValidator.php

@@ -2,12 +2,13 @@
 /**
  * CUniqueValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CUniqueValidator validates that the attribute value is unique in the corresponding database table.
  *

framework/validators/UnsafeValidator.php

@@ -2,12 +2,13 @@
 /**
  * CUnsafeValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CUnsafeValidator marks the associated attributes to be unsafe so that they cannot be massively assigned.
  *

framework/validators/UrlValidator.php

@@ -2,12 +2,13 @@
 /**
  * CUrlValidator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
  * CUrlValidator validates that the attribute value is a valid http or https URL.
  *

framework/validators/Validator.php

 <?php
 /**
- * CValidator class file.
+ * Validator class file.
  *
- * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @copyright Copyright &copy; 2008-2012 Yii Software LLC
  * @license http://www.yiiframework.com/license/
  */
 
+namespace yii\validators;
+
 /**
- * CValidator is the base class for all validators.
+ * Validator is the base class for all validators.
  *
  * Child classes must implement the {@link validateAttribute} method.
  *
@@ -52,33 +53,40 @@
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @version $Id: CValidator.php 3160 2011-04-03 01:08:23Z qiang.xue $
  * @package system.validators
- * @since 1.0
+ * @since 2.0
  */
-abstract class CValidator extends CComponent
+abstract class Validator extends \yii\base\Component
 {
 	/**
-	 * @var array list of built-in validators (name=>class)
+	 * @var array list of built-in validators (name => class or configuration)
 	 */
 	public static $builtInValidators = array(
-		'required' => 'CRequiredValidator',
-		'filter' => 'CFilterValidator',
-		'match' => 'CRegularExpressionValidator',
-		'email' => 'CEmailValidator',
-		'url' => 'CUrlValidator',
-		'unique' => 'CUniqueValidator',
-		'compare' => 'CCompareValidator',
-		'length' => 'CStringValidator',
-		'in' => 'CRangeValidator',
-		'numerical' => 'CNumberValidator',
-		'captcha' => 'CCaptchaValidator',
-		'type' => 'CTypeValidator',
-		'file' => 'CFileValidator',
-		'default' => 'CDefaultValueValidator',
-		'exist' => 'CExistValidator',
-		'boolean' => 'CBooleanValidator',
-		'safe' => 'CSafeValidator',
-		'unsafe' => 'CUnsafeValidator',
-		'date' => 'CDateValidator',
+		'required' => '\yii\validators\RequiredValidator',
+		'filter' => '\yii\validators\FilterValidator',
+		'match' => '\yii\validators\RegularExpressionValidator',
+		'email' => '\yii\validators\EmailValidator',
+		'url' => '\yii\validators\UrlValidator',
+		'compare' => '\yii\validators\CompareValidator',
+		'length' => '\yii\validators\StringValidator',
+		'in' => '\yii\validators\RangeValidator',
+		'numerical' => '\yii\validators\NumberValidator',
+
+		'boolean' => '\yii\validators\BooleanValidator',
+		'integer' => '\yii\validators\IntegerValidator',
+		'float' => '\yii\validators\FloatValidator',
+		'string' => '\yii\validators\StringValidator',
+		'date' => '\yii\validators\DateValidator',
+
+		'captcha' => '\yii\validators\CaptchaValidator',
+		'type' => '\yii\validators\TypeValidator',
+		'file' => '\yii\validators\FileValidator',
+		'default' => '\yii\validators\DefaultValueValidator',
+
+		'unique' => '\yii\validators\UniqueValidator',
+		'exist' => '\yii\validators\ExistValidator',
+
+		'safe' => '\yii\validators\SafeValidator',
+		'unsafe' => '\yii\validators\UnsafeValidator',
 	);
 
 	/**
@@ -86,126 +94,149 @@ abstract class CValidator extends CComponent
 	 */
 	public $attributes;
 	/**
-	 * @var string the user-defined error message. Different validators may define various
-	 * placeholders in the message that are to be replaced with actual values. All validators
-	 * recognize "{attribute}" placeholder, which will be replaced with the label of the attribute.
+	 * @var string the user-defined error message. Error message may contain some placeholders
+	 * that will be replaced with the actual values by the validator.
+	 * The `{attribute}` and `{value}` are placeholders supported by all validators.
+	 * They will be replaced with the attribute label and value, respectively.
 	 */
 	public $message;
 	/**
-	 * @var boolean whether this validation rule should be skipped if when there is already a validation
-	 * error for the current attribute. Defaults to false.
-	 * @since 1.1.1
-	 */
-	public $skipOnError = false;
-	/**
 	 * @var array list of scenarios that the validator should be applied.
 	 * Each array value refers to a scenario name with the same name as its array key.
 	 */
 	public $on;
 	/**
-	 * @var boolean whether attributes listed with this validator should be considered safe for massive assignment.
-	 * Defaults to true.
-	 * @since 1.1.4
+	 * @var boolean whether this validation rule should be skipped if the attribute being validated
+	 * already has some validation error according to the previous rules. Defaults to false.
+	 */
+	public $skipOnError = false;
+	/**
+	 * @var boolean whether attributes listed with this validator should be considered safe for
+	 * massive assignment. Defaults to true.
 	 */
 	public $safe = true;
 	/**
-	 * @var boolean whether to perform client-side validation. Defaults to true.
-	 * Please refer to {@link CActiveForm::enableClientValidation} for more details about client-side validation.
-	 * @since 1.1.7
+	 * @var boolean whether to enable client-side validation. Defaults to true.
+	 * Please refer to [[\yii\web\ActiveForm::enableClientValidation]] for more details about
+	 * client-side validation.
 	 */
 	public $enableClientValidation = true;
 
 	/**
+	 * Validates a value.
+	 * Child classes should override this method to implement the actual validation logic.
+	 * @param mixed $value the value being validated.
+	 * @return boolean whether the value is valid.
+	 */
+	abstract public function validateValue($value);
+
+	/**
 	 * Validates a single attribute.
-	 * This method should be overridden by child classes.
-	 * @param CModel $object the data object being validated
+	 * The default implementation will call [[validateValue]] to determine if
+	 * the attribute value is valid or not. If not, the [[message|error message]]
+	 * will be added to the model object.
+	 * @param \yii\base\Model $object the data object being validated
 	 * @param string $attribute the name of the attribute to be validated.
 	 */
-	abstract protected function validateAttribute($object, $attribute);
-
+	public function validateAttribute($object, $attribute)
+	{
+		if (!$this->validateValue($object->$attribute)) {
+			$this->addError($object, $attribute, $this->message);
+		}
+	}
 
 	/**
 	 * Creates a validator object.
-	 * @param string $name the name or class of the validator
-	 * @param CModel $object the data object being validated that may contain the inline validation method
+	 * @param string $type the validator type. This can be a method name,
+	 * a built-in validator name, a class name, or a path alias of validator class.
+	 * @param \yii\base\Model $object the data object being validated.
 	 * @param mixed $attributes list of attributes to be validated. This can be either an array of
 	 * the attribute names or a string of comma-separated attribute names.
 	 * @param array $params initial values to be applied to the validator properties
-	 * @return CValidator the validator
+	 * @return Validator the validator
 	 */
-	public static function createValidator($name, $object, $attributes, $params = array())
+	public static function createValidator($type, $object, $attributes, $params = array())
 	{
-		if (is_string($attributes))
+		if (!is_array($attributes)) {
 			$attributes = preg_split('/[\s,]+/', $attributes, -1, PREG_SPLIT_NO_EMPTY);
+		}
 
-		if (isset($params['on']))
-		{
-			if (is_array($params['on']))
+		if (isset($params['on'])) {
+			if (is_array($params['on'])) {
 				$on = $params['on'];
-			else
+			}
+			else {
 				$on = preg_split('/[\s,]+/', $params['on'], -1, PREG_SPLIT_NO_EMPTY);
+			}
+			$params['on'] = empty($on) ? array() : array_combine($on, $on);
+		}
+		else {
+			$params['on'] = array();
 		}
-		else
-			$on = array();
 
-		if (method_exists($object, $name))
-		{
-			$validator = new CInlineValidator;
-			$validator->attributes = $attributes;
-			$validator->method = $name;
-			$validator->params = $params;
-			if (isset($params['skipOnError']))
-				$validator->skipOnError = $params['skipOnError'];
+		if (method_exists($object, $type)) {  // method-based validator
+			$config = array(
+				'class'	=> '\yii\validators\InlineValidator',
+				'method' => $type,
+				'attributes' => $attributes,
+			);
 		}
-		else
-		{
-			$params['attributes'] = $attributes;
-			if (isset(self::$builtInValidators[$name]))
-				$className = Yii::import(self::$builtInValidators[$name], true);
-			else
-				$className = Yii::import($name, true);
-			$validator = new $className;
-			foreach ($params as $name => $value)
-				$validator->$name = $value;
+		else {
+			if (is_string($type) && isset(self::$builtInValidators[$type])) {
+				$type = self::$builtInValidators[$type];
+			}
+			$config = array(
+				'class'	=> $type,
+				'attributes' => $attributes,
+			);
+		}
+		$validator = \Yii::createComponent($config);
+		foreach ($params as $name => $value) {
+			$validator->$name = $value;
 		}
-
-		$validator->on = empty($on) ? array() : array_combine($on, $on);
 
 		return $validator;
 	}
 
 	/**
 	 * Validates the specified object.
-	 * @param CModel $object the data object being validated
+	 * @param \yii\base\Model $object the data object being validated
 	 * @param array $attributes the list of attributes to be validated. Defaults to null,
-	 * meaning every attribute listed in {@link attributes} will be validated.
+	 * meaning every attribute listed in [[attributes]] will be validated.
 	 */
 	public function validate($object, $attributes = null)
 	{
-		if (is_array($attributes))
+		if (is_array($attributes)) {
 			$attributes = array_intersect($this->attributes, $attributes);
-		else
+		}
+		else {
 			$attributes = $this->attributes;
-		foreach ($attributes as $attribute)
-		{
-			if (!$this->skipOnError || !$object->hasErrors($attribute))
+		}
+		foreach ($attributes as $attribute) {
+			if (!$this->skipOnError || !$object->hasErrors($attribute)) {
 				$this->validateAttribute($object, $attribute);
+			}
 		}
 	}
 
 	/**
 	 * Returns the JavaScript needed for performing client-side validation.
-	 * Do not override this method if the validator does not support client-side validation.
-	 * Two predefined JavaScript variables can be used:
-	 * <ul>
-	 * <li>value: the value to be validated</li>
-	 * <li>messages: an array used to hold the validation error messages for the value</li>
-	 * </ul>
-	 * @param CModel $object the data object being validated
+	 *
+	 * You may override this method to return the JavaScript validation code if
+	 * the validator can support client-side validation.
+	 *
+	 * The following JavaScript variables are predefined and can be used in the validation code:
+	 *
+	 * - `attribute`: the name of the attribute being validated.
+	 * - `value`: the value being validated.
+	 * - `messages`: an array used to hold the validation error messages for the attribute.
+	 *
+	 * @param \yii\base\Model $object the data object being validated
 	 * @param string $attribute the name of the attribute to be validated.
-	 * @return string the client-side validation script. Null if the validator does not support client-side validation.
-	 * @see CActiveForm::enableClientValidation
-	 * @since 1.1.7
+	 * @return string the client-side validation script. Null if the validator does not support
+	 * client-side validation.
+	 * @see enableClientValidation
+	 * @see \yii\web\ActiveForm::enableClientValidation
 	 */
 	public function clientValidateAttribute($object, $attribute)
 	{
@@ -214,13 +245,12 @@ abstract class CValidator extends CComponent
 	/**
 	 * Returns a value indicating whether the validator applies to the specified scenario.
 	 * A validator applies to a scenario as long as any of the following conditions is met:
-	 * <ul>
-	 * <li>the validator's "on" property is empty</li>
-	 * <li>the validator's "on" property contains the specified scenario</li>
-	 * </ul>
+	 *
+	 * - the validator's `on` property is empty
+	 * - the validator's `on` property contains the specified scenario
+	 *
 	 * @param string $scenario scenario name
 	 * @return boolean whether the validator applies to the specified scenario.
-	 * @since 1.0.2
 	 */
 	public function applyTo($scenario)
 	{
@@ -228,9 +258,9 @@ abstract class CValidator extends CComponent
 	}
 
 	/**
-	 * Adds an error about the specified attribute to the active record.
+	 * Adds an error about the specified attribute to the model object.
 	 * This is a helper method that performs message selection and internationalization.
-	 * @param CModel $object the data object being validated
+	 * @param \yii\base\Model $object the data object being validated
 	 * @param string $attribute the attribute being validated
 	 * @param string $message the error message
 	 * @param array $params values for the placeholders in the error message
@@ -238,6 +268,7 @@ abstract class CValidator extends CComponent
 	protected function addError($object, $attribute, $message, $params = array())
 	{
 		$params['{attribute}'] = $object->getAttributeLabel($attribute);
+		$params['{value}'] = $object->$attribute;
 		$object->addError($attribute, strtr($message, $params));
 	}
 
@@ -248,11 +279,10 @@ abstract class CValidator extends CComponent
 	 * @param mixed $value the value to be checked
 	 * @param boolean $trim whether to perform trimming before checking if the string is empty. Defaults to false.
 	 * @return boolean whether the value is empty
-	 * @since 1.0.9
 	 */
 	protected function isEmpty($value, $trim = false)
 	{
-		return $value === null || $value === array() || $value === '' || $trim && is_scalar($value) && trim($value) === '';
+		return $value === null || $value === array() || $value === ''
+				|| $trim && is_scalar($value) && trim($value) === '';
 	}
 }
-

upgrade.txt

@@ -10,3 +10,6 @@
 - `CList` is renamed to `Vector`, and `CMap` is renamed to `Dictionary`.
   Other collection classes are dropped in favor of SPL classes.
 
+- `CFormModel` is removed. Please use `yii\base\Model` instead.
+
+