From 2a71c72d7c8e3e2f66ef93c52952a6a3ad6da2c9 Mon Sep 17 00:00:00 2001
From: Qiang Xue <qiang.xue@gmail.com>
Date: Thu, 24 Oct 2013 21:24:30 -0400
Subject: [PATCH] fixes #1066: Added ActiveForm::validate() and
 validateMultiple()

---
 framework/yii/base/Model.php         |  9 +++-
 framework/yii/widgets/ActiveForm.php | 89 ++++++++++++++++++++++++++++++++++++
 2 files changed, 96 insertions(+), 2 deletions(-)

diff --git a/framework/yii/base/Model.php b/framework/yii/base/Model.php
index e469f66..99c1df9 100644
--- a/framework/yii/base/Model.php
+++ b/framework/yii/base/Model.php
@@ -748,16 +748,21 @@ class Model extends Component implements IteratorAggregate, ArrayAccess
 
 	/**
 	 * Validates multiple models.
+	 * This method will validate every model. The models being validated may
+	 * be of the same or different types.
 	 * @param array $models the models to be validated
+	 * @param array $attributes list of attributes that should be validated.
+	 * If this parameter is empty, it means any attribute listed in the applicable
+	 * validation rules should be validated.
 	 * @return boolean whether all models are valid. False will be returned if one
 	 * or multiple models have validation error.
 	 */
-	public static function validateMultiple($models)
+	public static function validateMultiple($models, $attributes = null)
 	{
 		$valid = true;
 		/** @var Model $model */
 		foreach ($models as $model) {
-			$valid = $model->validate() && $valid;
+			$valid = $model->validate($attributes) && $valid;
 		}
 		return $valid;
 	}
diff --git a/framework/yii/widgets/ActiveForm.php b/framework/yii/widgets/ActiveForm.php
index 13135cf..c018011 100644
--- a/framework/yii/widgets/ActiveForm.php
+++ b/framework/yii/widgets/ActiveForm.php
@@ -265,4 +265,93 @@ class ActiveForm extends Widget
 			'form' => $this,
 		]));
 	}
+
+	/**
+	 * Validates one or several models and returns an error message array indexed by the attribute IDs.
+	 * This is a helper method that simplifies the way of writing AJAX validation code.
+	 *
+	 * For example, you may use the following code in a controller action to respond
+	 * to an AJAX validation request:
+	 *
+	 * ~~~
+	 * $model = new Post;
+	 * $model->load($_POST);
+	 * if (Yii::$app->request->isAjax) {
+	 *     Yii::$app->response->format = Response::FORMAT_JSON;
+	 *     return ActiveForm::validate($model);
+	 * }
+	 * // ... respond to non-AJAX request ...
+	 * ~~~
+	 *
+	 * To validate multiple models, simply pass each model as a parameter to this method, like
+	 * the following:
+	 *
+	 * ~~~
+	 * ActiveForm::validate($model1, $model2, ...);
+	 * ~~~
+	 *
+	 * @param Model $model the model to be validated
+	 * @param mixed $attributes list of attributes that should be validated.
+	 * If this parameter is empty, it means any attribute listed in the applicable
+	 * validation rules should be validated.
+	 *
+	 * When this method is used to validate multiple models, this parameter will be interpreted
+	 * as a model.
+	 *
+	 * @return array the error message array indexed by the attribute IDs.
+	 */
+	public static function validate($model, $attributes = null)
+	{
+		$result = [];
+		if ($attributes instanceof Model) {
+			// validating multiple models
+			$models = func_get_args();
+			$attributes = null;
+		} else {
+			$models = [$model];
+		}
+		/** @var Model $model */
+		foreach ($models as $model) {
+			$model->validate($attributes);
+			foreach ($model->getErrors() as $attribute => $errors) {
+				$result[Html::getInputId($model, $attribute)] = $errors;
+			}
+		}
+		return $result;
+	}
+
+	/**
+	 * Validates an array of model instances and returns an error message array indexed by the attribute IDs.
+	 * This is a helper method that simplifies the way of writing AJAX validation code for tabular input.
+	 *
+	 * For example, you may use the following code in a controller action to respond
+	 * to an AJAX validation request:
+	 *
+	 * ~~~
+	 * // ... load $models ...
+	 * if (Yii::$app->request->isAjax) {
+	 *     Yii::$app->response->format = Response::FORMAT_JSON;
+	 *     return ActiveForm::validateMultiple($models);
+	 * }
+	 * // ... respond to non-AJAX request ...
+	 * ~~~
+	 *
+	 * @param array $models an array of models to be validated.
+	 * @param mixed $attributes list of attributes that should be validated.
+	 * If this parameter is empty, it means any attribute listed in the applicable
+	 * validation rules should be validated.
+	 * @return array the error message array indexed by the attribute IDs.
+	 */
+	public static function validateMultiple($models, $attributes = null)
+	{
+		$result = [];
+		/** @var Model $model */
+		foreach ($models as $i => $model) {
+			$model->validate($attributes);
+			foreach ($model->getErrors() as $attribute => $errors) {
+				$result[Html::getInputId($model, "[$i]" . $attribute)] = $errors;
+			}
+		}
+		return $result;
+	}
 }