ActiveForm::errorSummary() - Code Metrics - Inspection of "Commented out test is back" - yiisoft/yii2 - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — php7-travis-apcu ( 9bbcee...fd63c3 )

by Alexander

created 2017-07-30 09:35 UTC

ActiveForm::errorSummary() A

↳ Parent: ActiveForm

Complexity

Conditions	1
Paths	1

Size

Total Lines	6
Code Lines	4

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes

Metric	Value
dl	0
loc	6
rs	9.4285
c	0
b	0
f	0
ccs	0
cts	4
cp	0
cc	1
eloc	4
nc	1
nop	2
crap	2

<?php
/**
 * @link http://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */

namespace yii\widgets;

use Yii;
use yii\base\InvalidCallException;
use yii\base\Model;
use yii\base\Widget;
use yii\helpers\ArrayHelper;
use yii\helpers\Html;
use yii\helpers\Json;
use yii\helpers\Url;

/**
 * ActiveForm is a widget that builds an interactive HTML form for one or multiple data models.
 *
 * For more details and usage information on ActiveForm, see the [guide article on forms](guide:input-forms).
 *
 * @author Qiang Xue <[email protected]>
 * @since 2.0
 */
class ActiveForm extends Widget
{
    /**
     * @var array|string the form action URL. This parameter will be processed by [[\yii\helpers\Url::to()]].
     * @see method for specifying the HTTP method for this form.
     */
    public $action = '';
    /**
     * @var string the form submission method. This should be either `post` or `get`. Defaults to `post`.
     *
     * When you set this to `get` you may see the url parameters repeated on each request.
     * This is because the default value of [[action]] is set to be the current request url and each submit
     * will add new parameters instead of replacing existing ones.
     * You may set [[action]] explicitly to avoid this:
     *
     * ```php
     * $form = ActiveForm::begin([
     *     'method' => 'get',
     *     'action' => ['controller/action'],
     * ]);
     * ```
     */
    public $method = 'post';
    /**
     * @var array the HTML attributes (name-value pairs) for the form tag.
     * @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered.
     */
    public $options = [];
    /**
     * @var string the default field class name when calling [[field()]] to create a new field.
     * @see fieldConfig
     */
    public $fieldClass = ActiveField::class;
    /**
     * @var array|\Closure the default configuration used by [[field()]] when creating a new field object.
     * This can be either a configuration array or an anonymous function returning a configuration array.
     * If the latter, the signature should be as follows:
     *
     * ```php
     * function ($model, $attribute)
     * ```
     *
     * The value of this property will be merged recursively with the `$options` parameter passed to [[field()]].
     *
     * @see fieldClass
     */
    public $fieldConfig = [];
    /**
     * @var bool whether to perform encoding on the error summary.
     */
    public $encodeErrorSummary = true;
    /**
     * @var string the default CSS class for the error summary container.
     * @see errorSummary()
     */
    public $errorSummaryCssClass = 'error-summary';
    /**
     * @var string the CSS class that is added to a field container when the associated attribute is required.
     */
    public $requiredCssClass = 'required';
    /**
     * @var string the CSS class that is added to a field container when the associated attribute has validation error.
     */
    public $errorCssClass = 'has-error';
    /**
     * @var string the CSS class that is added to a field container when the associated attribute is successfully validated.
     */
    public $successCssClass = 'has-success';
    /**
     * @var string the CSS class that is added to a field container when the associated attribute is being validated.
     */
    public $validatingCssClass = 'validating';
    /**
     * @var bool whether to enable client-side data validation.
     * If [[ActiveField::enableClientValidation]] is set, its value will take precedence for that input field.
     */
    public $enableClientValidation = true;
    /**
     * @var bool whether to enable AJAX-based data validation.
     * If [[ActiveField::enableAjaxValidation]] is set, its value will take precedence for that input field.
     */
    public $enableAjaxValidation = false;
    /**
     * @var bool whether to hook up `yii.activeForm` JavaScript plugin.
     * This property must be set `true` if you want to support client validation and/or AJAX validation, or if you
     * want to take advantage of the `yii.activeForm` plugin. When this is `false`, the form will not generate
     * any JavaScript.
     * @see registerClientScript
     */
    public $enableClientScript = true;
    /**
     * @var array|string the URL for performing AJAX-based validation. This property will be processed by
     * [[Url::to()]]. Please refer to [[Url::to()]] for more details on how to configure this property.
     * If this property is not set, it will take the value of the form's action attribute.
     */
    public $validationUrl;
    /**
     * @var bool whether to perform validation when the form is submitted.
     */
    public $validateOnSubmit = true;
    /**
     * @var bool whether to perform validation when the value of an input field is changed.
     * If [[ActiveField::validateOnChange]] is set, its value will take precedence for that input field.
     */
    public $validateOnChange = true;
    /**
     * @var bool whether to perform validation when an input field loses focus.
     * If [[ActiveField::$validateOnBlur]] is set, its value will take precedence for that input field.
     */
    public $validateOnBlur = true;
    /**
     * @var bool whether to perform validation while the user is typing in an input field.
     * If [[ActiveField::validateOnType]] is set, its value will take precedence for that input field.
     * @see validationDelay
     */
    public $validateOnType = false;
    /**
     * @var int number of milliseconds that the validation should be delayed when the user types in the field
     * and [[validateOnType]] is set `true`.
     * If [[ActiveField::validationDelay]] is set, its value will take precedence for that input field.
     */
    public $validationDelay = 500;
    /**
     * @var string the name of the GET parameter indicating the validation request is an AJAX request.
     */
    public $ajaxParam = 'ajax';
    /**
     * @var string the type of data that you're expecting back from the server.
     */
    public $ajaxDataType = 'json';
    /**
     * @var bool whether to scroll to the first error after validation.
     * @since 2.0.6
     */
    public $scrollToError = true;
    /**
     * @var int offset in pixels that should be added when scrolling to the first error.
     * @since 2.0.11
     */
    public $scrollToErrorOffset = 0;
    /**
     * @var array the client validation options for individual attributes. Each element of the array
     * represents the validation options for a particular attribute.
     * @internal
     */
    public $attributes = [];

    /**
     * @var ActiveField[] the ActiveField objects that are currently active
     */
    private $_fields = [];


    /**
     * Initializes the widget.
     * This renders the form open tag.
     */
    public function init()
    {
        if (!isset($this->options['id'])) {
            $this->options['id'] = $this->getId();
        }
        ob_start();
        ob_implicit_flush(false);
    }

    /**
     * Runs the widget.
     * This registers the necessary JavaScript code and renders the form open and close tags.
     * @throws InvalidCallException if `beginField()` and `endField()` calls are not matching.
     */
    public function run()
    {
        if (!empty($this->_fields)) {
            throw new InvalidCallException('Each beginField() should have a matching endField() call.');
        }

        $content = ob_get_clean();
        $html = Html::beginForm($this->action, $this->method, $this->options);
        $html .= $content;

        if ($this->enableClientScript) {
            $this->registerClientScript();
        }

        $html .= Html::endForm();

        return $html;
    }

    /**
     * This registers the necessary JavaScript code.
     * @since 2.0.12
     */
    public function registerClientScript()
    {
        $id = $this->options['id'];
        $options = Json::htmlEncode($this->getClientOptions());
        $attributes = Json::htmlEncode($this->attributes);
        $view = $this->getView();
        ActiveFormAsset::register($view);
        $view->registerJs("jQuery('#$id').yiiActiveForm($attributes, $options);");
    }

    /**
     * Returns the options for the form JS widget.
     * @return array the options.
     */
    protected function getClientOptions()
    {
        $options = [
            'encodeErrorSummary' => $this->encodeErrorSummary,
            'errorSummary' => '.' . implode('.', preg_split('/\s+/', $this->errorSummaryCssClass, -1, PREG_SPLIT_NO_EMPTY)),
            'validateOnSubmit' => $this->validateOnSubmit,
            'errorCssClass' => $this->errorCssClass,
            'successCssClass' => $this->successCssClass,
            'validatingCssClass' => $this->validatingCssClass,
            'ajaxParam' => $this->ajaxParam,
            'ajaxDataType' => $this->ajaxDataType,
            'scrollToError' => $this->scrollToError,
            'scrollToErrorOffset' => $this->scrollToErrorOffset,
        ];
        if ($this->validationUrl !== null) {
            $options['validationUrl'] = Url::to($this->validationUrl);
        }

        // only get the options that are different from the default ones (set in yii.activeForm.js)
        return array_diff_assoc($options, [
            'encodeErrorSummary' => true,
            'errorSummary' => '.error-summary',
            'validateOnSubmit' => true,
            'errorCssClass' => 'has-error',
            'successCssClass' => 'has-success',
            'validatingCssClass' => 'validating',
            'ajaxParam' => 'ajax',
            'ajaxDataType' => 'json',
            'scrollToError' => true,
            'scrollToErrorOffset' => 0,
        ]);
    }

    /**
     * Generates a summary of the validation errors.
     * If there is no validation error, an empty error summary markup will still be generated, but it will be hidden.
     * @param Model|Model[] $models the model(s) associated with this form.
     * @param array $options the tag options in terms of name-value pairs. The following options are specially handled:
     *
     * - `header`: string, the header HTML for the error summary. If not set, a default prompt string will be used.
     * - `footer`: string, the footer HTML for the error summary.
     *
     * The rest of the options will be rendered as the attributes of the container tag. The values will
     * be HTML-encoded using [[\yii\helpers\Html::encode()]]. If a value is `null`, the corresponding attribute will not be rendered.
     * @return string the generated error summary.
     * @see errorSummaryCssClass
     */
    public function errorSummary($models, $options = [])
    {
        Html::addCssClass($options, $this->errorSummaryCssClass);
        $options['encode'] = $this->encodeErrorSummary;
        return Html::errorSummary($models, $options);
    }

    /**
     * Generates a form field.
     * A form field is associated with a model and an attribute. It contains a label, an input and an error message
     * and use them to interact with end users to collect their inputs for the attribute.
     * @param Model $model the data model.
     * @param string $attribute the attribute name or expression. See [[Html::getAttributeName()]] for the format
     * about attribute expression.
     * @param array $options the additional configurations for the field object. These are properties of [[ActiveField]]
     * or a subclass, depending on the value of [[fieldClass]].
     * @return ActiveField the created ActiveField object.
     * @see fieldConfig
     */
    public function field($model, $attribute, $options = [])
    {
        $config = $this->fieldConfig;
        if ($config instanceof \Closure) {
            $config = call_user_func($config, $model, $attribute);
        }
        if (!isset($config['class'])) {
            $config['class'] = $this->fieldClass;
        }
        return Yii::createObject(ArrayHelper::merge($config, $options, [
            'model' => $model,
            'attribute' => $attribute,
            'form' => $this,
        ]));
    }

    /**
     * Begins a form field.
     * This method will create a new form field and returns its opening tag.
     * You should call [[endField()]] afterwards.
     * @param Model $model the data model.
     * @param string $attribute the attribute name or expression. See [[Html::getAttributeName()]] for the format
     * about attribute expression.
     * @param array $options the additional configurations for the field object.
     * @return string the opening tag.
     * @see endField()
     * @see field()
     */
    public function beginField($model, $attribute, $options = [])
    {
        $field = $this->field($model, $attribute, $options);
        $this->_fields[] = $field;
        return $field->begin();
    }

    /**
     * Ends a form field.
     * This method will return the closing tag of an active form field started by [[beginField()]].
     * @return string the closing tag of the form field.
     * @throws InvalidCallException if this method is called without a prior [[beginField()]] call.
     */
    public function endField()
    {
        $field = array_pop($this->_fields);
        if ($field instanceof ActiveField) {
            return $field->end();
        }

        throw new InvalidCallException('Mismatching endField() call.');
    }

    /**
     * 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:
     *
     * ```php
     * $model = new Post;
     * $model->load(Yii::$app->request->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:
     *
     * ```php
     * 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:
     *
     * ```php
     * // ... 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;
    }
}


1		<?php
2		/**
3		* @link http://www.yiiframework.com/
4		* @copyright Copyright (c) 2008 Yii Software LLC
5		* @license http://www.yiiframework.com/license/
6		*/
7
8		namespace yii\widgets;
9
10		use Yii;
11		use yii\base\InvalidCallException;
12		use yii\base\Model;
13		use yii\base\Widget;
14		use yii\helpers\ArrayHelper;
15		use yii\helpers\Html;
16		use yii\helpers\Json;
17		use yii\helpers\Url;
18
19		/**
20		* ActiveForm is a widget that builds an interactive HTML form for one or multiple data models.
21		*
22		* For more details and usage information on ActiveForm, see the [guide article on forms](guide:input-forms).
23		*
24		* @author Qiang Xue <[email protected]>
25		* @since 2.0
26		*/
27		class ActiveForm extends Widget
28		{
29		/**
30		* @var array\|string the form action URL. This parameter will be processed by [[\yii\helpers\Url::to()]].
31		* @see method for specifying the HTTP method for this form.
32		*/
33		public $action = '';
34		/**
35		* @var string the form submission method. This should be either `post` or `get`. Defaults to `post`.
36		*
37		* When you set this to `get` you may see the url parameters repeated on each request.
38		* This is because the default value of [[action]] is set to be the current request url and each submit
39		* will add new parameters instead of replacing existing ones.
40		* You may set [[action]] explicitly to avoid this:
41		*
42		* ```php
43		* $form = ActiveForm::begin([
44		* 'method' => 'get',
45		* 'action' => ['controller/action'],
46		* ]);
47		* ```
48		*/
49		public $method = 'post';
50		/**
51		* @var array the HTML attributes (name-value pairs) for the form tag.
52		* @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered.
53		*/
54		public $options = [];
55		/**
56		* @var string the default field class name when calling [[field()]] to create a new field.
57		* @see fieldConfig
58		*/
59		public $fieldClass = ActiveField::class;
60		/**
61		* @var array\|\Closure the default configuration used by [[field()]] when creating a new field object.
62		* This can be either a configuration array or an anonymous function returning a configuration array.
63		* If the latter, the signature should be as follows:
64		*
65		* ```php
66		* function ($model, $attribute)
67		* ```
68		*
69		* The value of this property will be merged recursively with the `$options` parameter passed to [[field()]].
70		*
71		* @see fieldClass
72		*/
73		public $fieldConfig = [];
74		/**
75		* @var bool whether to perform encoding on the error summary.
76		*/
77		public $encodeErrorSummary = true;
78		/**
79		* @var string the default CSS class for the error summary container.
80		* @see errorSummary()
81		*/
82		public $errorSummaryCssClass = 'error-summary';
83		/**
84		* @var string the CSS class that is added to a field container when the associated attribute is required.
85		*/
86		public $requiredCssClass = 'required';
87		/**
88		* @var string the CSS class that is added to a field container when the associated attribute has validation error.
89		*/
90		public $errorCssClass = 'has-error';
91		/**
92		* @var string the CSS class that is added to a field container when the associated attribute is successfully validated.
93		*/
94		public $successCssClass = 'has-success';
95		/**
96		* @var string the CSS class that is added to a field container when the associated attribute is being validated.
97		*/
98		public $validatingCssClass = 'validating';
99		/**
100		* @var bool whether to enable client-side data validation.
101		* If [[ActiveField::enableClientValidation]] is set, its value will take precedence for that input field.
102		*/
103		public $enableClientValidation = true;
104		/**
105		* @var bool whether to enable AJAX-based data validation.
106		* If [[ActiveField::enableAjaxValidation]] is set, its value will take precedence for that input field.
107		*/
108		public $enableAjaxValidation = false;
109		/**
110		* @var bool whether to hook up `yii.activeForm` JavaScript plugin.
111		* This property must be set `true` if you want to support client validation and/or AJAX validation, or if you
112		* want to take advantage of the `yii.activeForm` plugin. When this is `false`, the form will not generate
113		* any JavaScript.
114		* @see registerClientScript
115		*/
116		public $enableClientScript = true;
117		/**
118		* @var array\|string the URL for performing AJAX-based validation. This property will be processed by
119		* [[Url::to()]]. Please refer to [[Url::to()]] for more details on how to configure this property.
120		* If this property is not set, it will take the value of the form's action attribute.
121		*/
122		public $validationUrl;
123		/**
124		* @var bool whether to perform validation when the form is submitted.
125		*/
126		public $validateOnSubmit = true;
127		/**
128		* @var bool whether to perform validation when the value of an input field is changed.
129		* If [[ActiveField::validateOnChange]] is set, its value will take precedence for that input field.
130		*/
131		public $validateOnChange = true;
132		/**
133		* @var bool whether to perform validation when an input field loses focus.
134		* If [[ActiveField::$validateOnBlur]] is set, its value will take precedence for that input field.
135		*/
136		public $validateOnBlur = true;
137		/**
138		* @var bool whether to perform validation while the user is typing in an input field.
139		* If [[ActiveField::validateOnType]] is set, its value will take precedence for that input field.
140		* @see validationDelay
141		*/
142		public $validateOnType = false;
143		/**
144		* @var int number of milliseconds that the validation should be delayed when the user types in the field
145		* and [[validateOnType]] is set `true`.
146		* If [[ActiveField::validationDelay]] is set, its value will take precedence for that input field.
147		*/
148		public $validationDelay = 500;
149		/**
150		* @var string the name of the GET parameter indicating the validation request is an AJAX request.
151		*/
152		public $ajaxParam = 'ajax';
153		/**
154		* @var string the type of data that you're expecting back from the server.
155		*/
156		public $ajaxDataType = 'json';
157		/**
158		* @var bool whether to scroll to the first error after validation.
159		* @since 2.0.6
160		*/
161		public $scrollToError = true;
162		/**
163		* @var int offset in pixels that should be added when scrolling to the first error.
164		* @since 2.0.11
165		*/
166		public $scrollToErrorOffset = 0;
167		/**
168		* @var array the client validation options for individual attributes. Each element of the array
169		* represents the validation options for a particular attribute.
170		* @internal
171		*/
172		public $attributes = [];
173
174		/**
175		* @var ActiveField[] the ActiveField objects that are currently active
176		*/
177		private $_fields = [];
178
179
180		/**
181		* Initializes the widget.
182		* This renders the form open tag.
183		*/
184	32	public function init()
185		{
186	32	if (!isset($this->options['id'])) {
187	32	$this->options['id'] = $this->getId();
188		}
189	32	ob_start();
190	32	ob_implicit_flush(false);
191	32	}
192
193		/**
194		* Runs the widget.
195		* This registers the necessary JavaScript code and renders the form open and close tags.
196		* @throws InvalidCallException if `beginField()` and `endField()` calls are not matching.
197		*/
198	32	public function run()
199		{
200	32	if (!empty($this->_fields)) {
201		throw new InvalidCallException('Each beginField() should have a matching endField() call.');
202		}
203
204	32	$content = ob_get_clean();
205	32	$html = Html::beginForm($this->action, $this->method, $this->options);
206	32	$html .= $content;
207
208	32	if ($this->enableClientScript) {
209	1	$this->registerClientScript();
210		}
211
212	32	$html .= Html::endForm();
213
214	32	return $html;
215		}
216
217		/**
218		* This registers the necessary JavaScript code.
219		* @since 2.0.12
220		*/
221	1	public function registerClientScript()
222		{
223	1	$id = $this->options['id'];
224	1	$options = Json::htmlEncode($this->getClientOptions());
225	1	$attributes = Json::htmlEncode($this->attributes);
226	1	$view = $this->getView();
227	1	ActiveFormAsset::register($view);
228	1	$view->registerJs("jQuery('#$id').yiiActiveForm($attributes, $options);");
229	1	}
230
231		/**
232		* Returns the options for the form JS widget.
233		* @return array the options.
234		*/
235	1	protected function getClientOptions()
236		{
237		$options = [
238	1	'encodeErrorSummary' => $this->encodeErrorSummary,
239	1	'errorSummary' => '.' . implode('.', preg_split('/\s+/', $this->errorSummaryCssClass, -1, PREG_SPLIT_NO_EMPTY)),
240	1	'validateOnSubmit' => $this->validateOnSubmit,
241	1	'errorCssClass' => $this->errorCssClass,
242	1	'successCssClass' => $this->successCssClass,
243	1	'validatingCssClass' => $this->validatingCssClass,
244	1	'ajaxParam' => $this->ajaxParam,
245	1	'ajaxDataType' => $this->ajaxDataType,
246	1	'scrollToError' => $this->scrollToError,
247	1	'scrollToErrorOffset' => $this->scrollToErrorOffset,
248		];
249	1	if ($this->validationUrl !== null) {
250		$options['validationUrl'] = Url::to($this->validationUrl);
251		}
252
253		// only get the options that are different from the default ones (set in yii.activeForm.js)
254	1	return array_diff_assoc($options, [
255	1	'encodeErrorSummary' => true,
256		'errorSummary' => '.error-summary',
257		'validateOnSubmit' => true,
258		'errorCssClass' => 'has-error',
259		'successCssClass' => 'has-success',
260		'validatingCssClass' => 'validating',
261		'ajaxParam' => 'ajax',
262		'ajaxDataType' => 'json',
263		'scrollToError' => true,
264		'scrollToErrorOffset' => 0,
265		]);
266		}
267
268		/**
269		* Generates a summary of the validation errors.
270		* If there is no validation error, an empty error summary markup will still be generated, but it will be hidden.
271		* @param Model\|Model[] $models the model(s) associated with this form.
272		* @param array $options the tag options in terms of name-value pairs. The following options are specially handled:
273		*
274		* - `header`: string, the header HTML for the error summary. If not set, a default prompt string will be used.
275		* - `footer`: string, the footer HTML for the error summary.
276		*
277		* The rest of the options will be rendered as the attributes of the container tag. The values will
278		* be HTML-encoded using [[\yii\helpers\Html::encode()]]. If a value is `null`, the corresponding attribute will not be rendered.
279		* @return string the generated error summary.
280		* @see errorSummaryCssClass
281		*/
282		public function errorSummary($models, $options = [])
283		{
284		Html::addCssClass($options, $this->errorSummaryCssClass);
285		$options['encode'] = $this->encodeErrorSummary;
286		return Html::errorSummary($models, $options);
287		}
288
289		/**
290		* Generates a form field.
291		* A form field is associated with a model and an attribute. It contains a label, an input and an error message
292		* and use them to interact with end users to collect their inputs for the attribute.
293		* @param Model $model the data model.
294		* @param string $attribute the attribute name or expression. See [[Html::getAttributeName()]] for the format
295		* about attribute expression.
296		* @param array $options the additional configurations for the field object. These are properties of [[ActiveField]]
297		* or a subclass, depending on the value of [[fieldClass]].
298		* @return ActiveField the created ActiveField object.
299		* @see fieldConfig
300		*/
301	4	public function field($model, $attribute, $options = [])
302		{
303	4	$config = $this->fieldConfig;
304	4	if ($config instanceof \Closure) {
305		$config = call_user_func($config, $model, $attribute);
306		}
307	4	if (!isset($config['class'])) {
308	4	$config['class'] = $this->fieldClass;
309		}
310	4	return Yii::createObject(ArrayHelper::merge($config, $options, [
311	4	'model' => $model,
312	4	'attribute' => $attribute,
313	4	'form' => $this,
314		]));
315		}
316
317		/**
318		* Begins a form field.
319		* This method will create a new form field and returns its opening tag.
320		* You should call [[endField()]] afterwards.
321		* @param Model $model the data model.
322		* @param string $attribute the attribute name or expression. See [[Html::getAttributeName()]] for the format
323		* about attribute expression.
324		* @param array $options the additional configurations for the field object.
325		* @return string the opening tag.
326		* @see endField()
327		* @see field()
328		*/
329		public function beginField($model, $attribute, $options = [])
330		{
331		$field = $this->field($model, $attribute, $options);
332		$this->_fields[] = $field;
333		return $field->begin();
334		}
335
336		/**
337		* Ends a form field.
338		* This method will return the closing tag of an active form field started by [[beginField()]].
339		* @return string the closing tag of the form field.
340		* @throws InvalidCallException if this method is called without a prior [[beginField()]] call.
341		*/
342		public function endField()
343		{
344		$field = array_pop($this->_fields);
345		if ($field instanceof ActiveField) {
346		return $field->end();
347		}
348
349		throw new InvalidCallException('Mismatching endField() call.');
350		}
351
352		/**
353		* Validates one or several models and returns an error message array indexed by the attribute IDs.
354		* This is a helper method that simplifies the way of writing AJAX validation code.
355		*
356		* For example, you may use the following code in a controller action to respond
357		* to an AJAX validation request:
358		*
359		* ```php
360		* $model = new Post;
361		* $model->load(Yii::$app->request->post());
362		* if (Yii::$app->request->isAjax) {
363		* Yii::$app->response->format = Response::FORMAT_JSON;
364		* return ActiveForm::validate($model);
365		* }
366		* // ... respond to non-AJAX request ...
367		* ```
368		*
369		* To validate multiple models, simply pass each model as a parameter to this method, like
370		* the following:
371		*
372		* ```php
373		* ActiveForm::validate($model1, $model2, ...);
374		* ```
375		*
376		* @param Model $model the model to be validated.
377		* @param mixed $attributes list of attributes that should be validated.
378		* If this parameter is empty, it means any attribute listed in the applicable
379		* validation rules should be validated.
380		*
381		* When this method is used to validate multiple models, this parameter will be interpreted
382		* as a model.
383		*
384		* @return array the error message array indexed by the attribute IDs.
385		*/
386		public static function validate($model, $attributes = null)
387		{
388		$result = [];
389		if ($attributes instanceof Model) {
390		// validating multiple models
391		$models = func_get_args();
392		$attributes = null;
393		} else {
394		$models = [$model];
395		}
396		/* @var $model Model */
397		foreach ($models as $model) {
398		$model->validate($attributes);
399		foreach ($model->getErrors() as $attribute => $errors) {
400		$result[Html::getInputId($model, $attribute)] = $errors;
401		}
402		}
403
404		return $result;
405		}
406
407		/**
408		* Validates an array of model instances and returns an error message array indexed by the attribute IDs.
409		* This is a helper method that simplifies the way of writing AJAX validation code for tabular input.
410		*
411		* For example, you may use the following code in a controller action to respond
412		* to an AJAX validation request:
413		*
414		* ```php
415		* // ... load $models ...
416		* if (Yii::$app->request->isAjax) {
417		* Yii::$app->response->format = Response::FORMAT_JSON;
418		* return ActiveForm::validateMultiple($models);
419		* }
420		* // ... respond to non-AJAX request ...
421		* ```
422		*
423		* @param array $models an array of models to be validated.
424		* @param mixed $attributes list of attributes that should be validated.
425		* If this parameter is empty, it means any attribute listed in the applicable
426		* validation rules should be validated.
427		* @return array the error message array indexed by the attribute IDs.
428		*/
429		public static function validateMultiple($models, $attributes = null)
430		{
431		$result = [];
432		/* @var $model Model */
433		foreach ($models as $i => $model) {
434		$model->validate($attributes);
435		foreach ($model->getErrors() as $attribute => $errors) {
436		$result[Html::getInputId($model, "[$i]" . $attribute)] = $errors;
437		}
438		}
439
440		return $result;
441		}
442		}
443

yiisoft / yii2

Push — php7-travis-apcu ( 9bbcee...fd63c3 )

ActiveForm::errorSummary() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like