mirror of
				https://github.com/yiisoft/yii2.git
				synced 2025-11-01 03:26:36 +08:00 
			
		
		
		
	
		
			
				
	
	
		
			107 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
			
		
		
	
	
			107 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
| <?php
 | |
| /**
 | |
|  * @link https://www.yiiframework.com/
 | |
|  * @copyright Copyright (c) 2008 Yii Software LLC
 | |
|  * @license https://www.yiiframework.com/license/
 | |
|  */
 | |
| 
 | |
| namespace yii\validators;
 | |
| 
 | |
| use Yii;
 | |
| use yii\helpers\Json;
 | |
| 
 | |
| /**
 | |
|  * BooleanValidator checks if the attribute value is a boolean value.
 | |
|  *
 | |
|  * Possible boolean values can be configured via the [[trueValue]] and [[falseValue]] properties.
 | |
|  * And the comparison can be either [[strict]] or not.
 | |
|  *
 | |
|  * @author Qiang Xue <qiang.xue@gmail.com>
 | |
|  * @since 2.0
 | |
|  */
 | |
| class BooleanValidator extends Validator
 | |
| {
 | |
|     /**
 | |
|      * @var mixed the value representing true status. Defaults to '1'.
 | |
|      */
 | |
|     public $trueValue = '1';
 | |
|     /**
 | |
|      * @var mixed the value representing false status. Defaults to '0'.
 | |
|      */
 | |
|     public $falseValue = '0';
 | |
|     /**
 | |
|      * @var bool whether the comparison to [[trueValue]] and [[falseValue]] is strict.
 | |
|      * When this is true, the attribute value and type must both match those of [[trueValue]] or [[falseValue]].
 | |
|      * Defaults to false, meaning only the value needs to be matched.
 | |
|      */
 | |
|     public $strict = false;
 | |
| 
 | |
| 
 | |
|     /**
 | |
|      * {@inheritdoc}
 | |
|      */
 | |
|     public function init()
 | |
|     {
 | |
|         parent::init();
 | |
|         if ($this->message === null) {
 | |
|             $this->message = Yii::t('yii', '{attribute} must be either "{true}" or "{false}".');
 | |
|         }
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * {@inheritdoc}
 | |
|      */
 | |
|     protected function validateValue($value)
 | |
|     {
 | |
|         if ($this->strict) {
 | |
|             $valid = $value === $this->trueValue || $value === $this->falseValue;
 | |
|         } else {
 | |
|             $valid = $value == $this->trueValue || $value == $this->falseValue;
 | |
|         }
 | |
| 
 | |
|         if (!$valid) {
 | |
|             return [$this->message, [
 | |
|                 'true' => $this->trueValue === true ? 'true' : $this->trueValue,
 | |
|                 'false' => $this->falseValue === false ? 'false' : $this->falseValue,
 | |
|             ]];
 | |
|         }
 | |
| 
 | |
|         return null;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * {@inheritdoc}
 | |
|      */
 | |
|     public function clientValidateAttribute($model, $attribute, $view)
 | |
|     {
 | |
|         ValidationAsset::register($view);
 | |
|         $options = $this->getClientOptions($model, $attribute);
 | |
| 
 | |
|         return 'yii.validation.boolean(value, messages, ' . Json::htmlEncode($options) . ');';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * {@inheritdoc}
 | |
|      */
 | |
|     public function getClientOptions($model, $attribute)
 | |
|     {
 | |
|         $options = [
 | |
|             'trueValue' => $this->trueValue,
 | |
|             'falseValue' => $this->falseValue,
 | |
|             'message' => $this->formatMessage($this->message, [
 | |
|                 'attribute' => $model->getAttributeLabel($attribute),
 | |
|                 'true' => $this->trueValue === true ? 'true' : $this->trueValue,
 | |
|                 'false' => $this->falseValue === false ? 'false' : $this->falseValue,
 | |
|             ]),
 | |
|         ];
 | |
|         if ($this->skipOnEmpty) {
 | |
|             $options['skipOnEmpty'] = 1;
 | |
|         }
 | |
|         if ($this->strict) {
 | |
|             $options['strict'] = 1;
 | |
|         }
 | |
| 
 | |
|         return $options;
 | |
|     }
 | |
| }
 | 
