/* Decoded by unphp.net */ 128], * ['email', 'email'], * ]); * if ($model->hasErrors()) { * // validation fails * } else { * // validation succeeds * } * } * ``` * * The above example shows how to validate `$name` and `$email` with the help of DynamicModel. * The [[validateData()]] method creates an instance of DynamicModel, defines the attributes * using the given data (`name` and `email` in this example), and then calls [[Model::validate()]]. * * You can check the validation result using [[hasErrors()]], like you do with a normal model. * You may also access the dynamic attributes defined through the model instance, e.g., * `$model->name` and `$model->email`. * * Alternatively, you may use the following more "classic" syntax to perform ad-hoc data validation: * * ```php * $model = new DynamicModel(compact('name', 'email')); * $model->addRule(['name', 'email'], 'string', ['max' => 128]) * ->addRule('email', 'email') * ->validate(); * ``` * * @author Qiang Xue * @since 2.0 */ class DynamicModel extends Model { /** * @var mixed[] dynamic attribute values (name => value). */ private $_attributes = []; /** * @var string[] dynamic attribute labels (name => label). * Used as form field labels and in validation error messages. * @since 2.0.35 */ private $_attributeLabels = []; /** * Constructor. * @param array $attributes the attributes (name-value pairs, or names) being defined. * @param array $config the configuration array to be applied to this object. */ public function __construct(array $attributes = [], $config = []) { foreach ($attributes as $name => $value) { if (is_int($name)) { $this->_attributes[$value] = null; } else { $this->_attributes[$name] = $value; } } parent::__construct($config); } /** * {@inheritdoc} */ public function __get($name) { if ($this->hasAttribute($name)) { return $this->_attributes[$name]; } return parent::__get($name); } /** * {@inheritdoc} */ public function __set($name, $value) { if ($this->hasAttribute($name)) { $this->_attributes[$name] = $value; } else { parent::__set($name, $value); } } /** * {@inheritdoc} */ public function __isset($name) { if ($this->hasAttribute($name)) { return isset($this->_attributes[$name]); } return parent::__isset($name); } /** * {@inheritdoc} */ public function __unset($name) { if ($this->hasAttribute($name)) { unset($this->_attributes[$name]); } else { parent::__unset($name); } } /** * {@inheritdoc} */ public function canGetProperty($name, $checkVars = true, $checkBehaviors = true) { return parent::canGetProperty($name, $checkVars, $checkBehaviors) || $this->hasAttribute($name); } /** * {@inheritdoc} */ public function canSetProperty($name, $checkVars = true, $checkBehaviors = true) { return parent::canSetProperty($name, $checkVars, $checkBehaviors) || $this->hasAttribute($name); } /** * Returns a value indicating whether the model has an attribute with the specified name. * @param string $name the name of the attribute. * @return bool whether the model has an attribute with the specified name. * @since 2.0.16 */ public function hasAttribute($name) { return array_key_exists($name, $this->_attributes); } /** * Defines an attribute. * @param string $name the attribute name. * @param mixed $value the attribute value. */ public function defineAttribute($name, $value = null) { $this->_attributes[$name] = $value; } /** * Undefines an attribute. * @param string $name the attribute name. */ public function undefineAttribute($name) { unset($this->_attributes[$name]); } /** * Adds a validation rule to this model. * You can also directly manipulate [[validators]] to add or remove validation rules. * This method provides a shortcut. * @param string|array $attributes the attribute(s) to be validated by the rule. * @param string|Validator|\Closure $validator the validator. This can be either: * * a built-in validator name listed in [[builtInValidators]]; * * a method name of the model class; * * an anonymous function; * * a validator class name. * * a Validator. * @param array $options the options (name-value pairs) to be applied to the validator. * @return $this */ public function addRule($attributes, $validator, $options = []) { $validators = $this->getValidators(); if ($validator instanceof Validator) { $validator->attributes = (array)$attributes; } else { $validator = Validator::createValidator($validator, $this, (array)$attributes, $options); } $validators->append($validator); $this->defineAttributesByValidator($validator); return $this; } /** * Validates the given data with the specified validation rules. * This method will create a DynamicModel instance, populate it with the data to be validated, * create the specified validation rules, and then validate the data using these rules. * @param array $data the data (name-value pairs) to be validated. * @param array $rules the validation rules. Please refer to [[Model::rules()]] on the format of this parameter. * @return static the model instance that contains the data being validated. * @throws InvalidConfigException if a validation rule is not specified correctly. */ public static function validateData(array $data, $rules = []) { /* @var $model DynamicModel */ $model = new static($data); if (!empty($rules)) { $validators = $model->getValidators(); foreach ($rules as $rule) { if ($rule instanceof Validator) { $validators->append($rule); $model->defineAttributesByValidator($rule); } elseif (is_array($rule) && isset($rule[0], $rule[1])) { // attributes, validator type $validator = Validator::createValidator($rule[1], $model, (array)$rule[0], array_slice($rule, 2)); $validators->append($validator); $model->defineAttributesByValidator($validator); } else { throw new InvalidConfigException('Invalid validation rule: a rule must specify both attribute names and validator type.'); } } } $model->validate(); return $model; } /** * Define the attributes that applies to the specified Validator. * @param Validator $validator the validator whose attributes are to be defined. */ private function defineAttributesByValidator($validator) { foreach ($validator->getAttributeNames() as $attribute) { if (!$this->hasAttribute($attribute)) { $this->defineAttribute($attribute); } } } /** * {@inheritdoc} */ public function attributes() { return array_keys($this->_attributes); } /** * Sets the labels for all attributes. * @param string[] $labels attribute labels. * @return $this * @since 2.0.35 */ public function setAttributeLabels(array $labels = []) { $this->_attributeLabels = $labels; return $this; } /** * Sets a label for a single attribute. * @param string $attribute attribute name. * @param string $label attribute label value. * @return $this * @since 2.0.35 */ public function setAttributeLabel($attribute, $label) { $this->_attributeLabels[$attribute] = $label; return $this; } /** * {@inheritdoc} */ public function attributeLabels() { return $this->_attributeLabels; } } ?>