Class craft\validators\StringValidator

Inheritance: craft\validators\StringValidator » yii\validators\StringValidator » yii\validators\Validator » yii\base\Component » yii\base\BaseObject
Implements: yii\base\Configurable
Available since version: 3.0
Source Code: https://github.com/craftcms/cms/blob/master/src/validators/StringValidator.php

Class StringValidator.

Public Properties
Property	Type	Description	Defined By
`$attributes`	array, string	Attributes to be validated by this validator.	yii\validators\Validator
`$builtInValidators`	array	List of built-in validators (name => class or configuration)	yii\validators\Validator
`$containsMb4`	string	User-defined error message used when the value contains 4+ byte characters (like emoji) and the database doesn’t support it.	craft\validators\StringValidator
`$disallowMb4`	boolean	Whether the string should be checked for 4+ byte characters (like emoji)	craft\validators\StringValidator
`$enableClientValidation`	boolean	Whether to enable client-side validation for this validator.	yii\validators\Validator
`$encoding`	string	The encoding of the string value to be validated (e.g. 'UTF-8').	yii\validators\StringValidator
`$except`	array, string	Scenarios that the validator should not be applied to.	yii\validators\Validator
`$isEmpty`	callable	A PHP callable that replaces the default implementation of isEmpty().	yii\validators\Validator
`$length`	integer, array	Specifies the length limit of the value to be validated.	yii\validators\StringValidator
`$max`	integer	Maximum length.	yii\validators\StringValidator
`$message`	string	User-defined error message used when the value is not a string.	yii\validators\StringValidator
`$min`	integer	Minimum length.	yii\validators\StringValidator
`$notEqual`	string	User-defined error message used when the length of the value is not equal to $length.	yii\validators\StringValidator
`$on`	array, string	Scenarios that the validator can be applied to.	yii\validators\Validator
`$skipOnEmpty`	boolean	Whether this validation rule should be skipped if the attribute value is null or an empty string.	yii\validators\Validator
`$skipOnError`	boolean	Whether this validation rule should be skipped if the attribute being validated already has some validation error according to some previous rules.	yii\validators\Validator
`$tooLong`	string	User-defined error message used when the length of the value is greater than $max.	yii\validators\StringValidator
`$tooShort`	string	User-defined error message used when the length of the value is smaller than $min.	yii\validators\StringValidator
`$when`	callable	A PHP callable whose return value determines whether this validator should be applied.	yii\validators\Validator
`$whenClient`	string	A JavaScript function name whose return value determines whether this validator should be applied on the client-side.	yii\validators\Validator

Public Methods
Method	Description	Defined By
`__call()`	Calls the named method which is not a class method.	yii\base\BaseObject
`__clone()`	This method is called after the object is created by cloning an existing one.	yii\base\Component
`__construct()`	Constructor.	yii\base\BaseObject
`__get()`	Returns the value of an object property.	yii\base\BaseObject
`__isset()`	Checks if a property is set, i.e. defined and not null.	yii\base\BaseObject
`__set()`	Sets value of an object property.	yii\base\BaseObject
`__unset()`	Sets an object property to null.	yii\base\BaseObject
`addError()`	Adds an error about the specified attribute to the model object.	yii\validators\Validator
`attachBehavior()`	Attaches a behavior to this component.	yii\base\Component
`attachBehaviors()`	Attaches a list of behaviors to the component.	yii\base\Component
`behaviors()`	Returns a list of behaviors that this component should behave as.	yii\base\Component
`canGetProperty()`	Returns a value indicating whether a property can be read.	yii\base\BaseObject
`canSetProperty()`	Returns a value indicating whether a property can be set.	yii\base\BaseObject
`className()`	Returns the fully qualified name of this class.	yii\base\BaseObject
`clientValidateAttribute()`	{@inheritdoc}	yii\validators\StringValidator
`createValidator()`	Creates a validator object.	yii\validators\Validator
`detachBehavior()`	Detaches a behavior from the component.	yii\base\Component
`detachBehaviors()`	Detaches all behaviors from the component.	yii\base\Component
`ensureBehaviors()`	Makes sure that the behaviors declared in behaviors() are attached to this component.	yii\base\Component
`getAttributeNames()`	Returns cleaned attribute names without the `!` character at the beginning.	yii\validators\Validator
`getBehavior()`	Returns the named behavior object.	yii\base\Component
`getBehaviors()`	Returns all behaviors attached to this component.	yii\base\Component
`getClientOptions()`	{@inheritdoc}	yii\validators\StringValidator
`hasEventHandlers()`	Returns a value indicating whether there is any handler attached to the named event.	yii\base\Component
`hasMethod()`	Returns a value indicating whether a method is defined.	yii\base\BaseObject
`hasProperty()`	Returns a value indicating whether a property is defined.	yii\base\BaseObject
`init()`	{@inheritdoc}	craft\validators\StringValidator
`isActive()`	Returns a value indicating whether the validator is active for the given scenario and attribute.	yii\validators\Validator
`isEmpty()`	Checks if the given value is empty.	yii\validators\Validator
`off()`	Detaches an existing event handler from this component.	yii\base\Component
`on()`	Attaches an event handler to an event.	yii\base\Component
`trigger()`	Triggers an event.	yii\base\Component
`validate()`	Validates a given value.	yii\validators\Validator
`validateAttribute()`	{@inheritdoc}	craft\validators\StringValidator
`validateAttributes()`	Validates the specified object.	yii\validators\Validator
`validateValue()`	{@inheritdoc}	craft\validators\StringValidator

Protected Methods
Method	Description	Defined By
`formatMessage()`	Formats a mesage using the I18N, or simple strtr if `\Yii::$app` is not available.	yii\validators\Validator

Property Details

`$containsMb4` public property #

User-defined error message used when the value contains 4+ byte characters (like emoji) and the database doesn’t support it.

public string $containsMb4 = null

`$disallowMb4` public property #

Whether the string should be checked for 4+ byte characters (like emoji)

public boolean $disallowMb4 = false

Method Details

`init()` public method #

{@inheritdoc}

public void init ( )

`validateAttribute()` public method #

{@inheritdoc}

public void validateAttribute ( $model, $attribute )

`$model`
`$attribute`

`validateValue()` public method #

{@inheritdoc}

public void validateValue ( $value )

$value

Property Details

$containsMb4 public property #

$disallowMb4 public property #

Method Details

init() public method #

validateAttribute() public method #

validateValue() public method #

`$containsMb4` public property #

`$disallowMb4` public property #

`init()` public method #

`validateAttribute()` public method #

`validateValue()` public method #