Class yii\data\ActiveDataFilter

继承yii\data\ActiveDataFilter » yii\data\DataFilter » yii\base\Model » yii\base\Component » yii\base\BaseObject
实现ArrayAccess, IteratorAggregate, yii\base\Arrayable, yii\base\Configurable, yii\base\StaticInstanceInterface
Uses Traitsyii\base\ArrayableTrait, yii\base\StaticInstanceTrait
可用自版本2.0.13
源代码 https://github.com/yiisoft/yii2/blob/master/framework/data/ActiveDataFilter.php

ActiveDataFilter allows composing a filtering condition in a format suitable for yii\db\QueryInterface::where().

参见 yii\data\DataFilter.

公共属性

隐藏继承的属性

属性类型描述定义在
$activeValidators yii\validators\Validator[] The validators applicable to the current $scenario. yii\base\Model
$attributeMap array Actual attribute names to be used in searched condition, in format: [filterAttribute => actualAttribute]. yii\data\DataFilter
$attributes array Attribute values (name => value). yii\base\Model
$behaviors yii\base\Behavior[] 附加到此组件的行为列表. yii\base\Component
$conditionBuilders array Maps filtering condition keywords to build methods. yii\data\ActiveDataFilter
$conditionValidators array Maps filter condition keywords to validation methods. yii\data\DataFilter
$errorMessages array Error messages in format [errorKey => message]. yii\data\DataFilter
$errors array Errors for all attributes or the specified attribute. yii\base\Model
$filter mixed Raw filter value. yii\data\DataFilter
$filterAttributeLabel string Label for the filter attribute specified via $filterAttributeName. yii\data\DataFilter
$filterAttributeName string Name of the attribute that handles filter value. yii\data\DataFilter
$filterControls array Keywords or expressions that could be used in a filter. yii\data\DataFilter
$firstErrors array The first errors. yii\base\Model
$iterator ArrayIterator An iterator for traversing the items in the list. yii\base\Model
$multiValueOperators array List of operators keywords, which should accept multiple values. yii\data\DataFilter
$operatorTypes array Specifies the list of supported search attribute types per each operator. yii\data\DataFilter
$queryOperatorMap array Map filtering operators to operators used in yii\db\QueryInterface::where(). yii\data\ActiveDataFilter
$scenario string The scenario that this model is in. yii\base\Model
$searchAttributeTypes array Search attribute type map. yii\data\DataFilter
$searchModel yii\base\Model Model instance. yii\data\DataFilter
$validators ArrayObject|yii\validators\Validator[] All the validators declared in the model. yii\base\Model

公共方法

隐藏继承的方法

方法描述定义在
__call() 调用不是类方法的指定的方法. yii\base\Component
__clone() 在通过克隆现有对象创建对象之后调用此方法. yii\base\Component
__construct() 构造函数. yii\base\BaseObject
__get() 返回组件属性的值. yii\base\Component
__isset() 检查属性是否已设置, 即已定义且不为null. yii\base\Component
__set() 设置组件属性的值. yii\base\Component
__unset() 将组件属性设置为null. yii\base\Component
activeAttributes() Returns the attribute names that are subject to validation in the current scenario. yii\base\Model
addError() Adds a new error to the specified attribute. yii\base\Model
addErrors() Adds a list of errors. yii\base\Model
afterValidate() This method is invoked after validation ends. yii\base\Model
attachBehavior() 将行为附加到此组件. yii\base\Component
attachBehaviors() 将行为列表附加到组件. yii\base\Component
attributeHints() Returns the attribute hints. yii\base\Model
attributeLabels() Returns the attribute labels. yii\base\Model
attributes() Returns the list of attribute names. yii\base\Model
beforeValidate() This method is invoked before validation starts. yii\base\Model
behaviors() 返回此组件应该具有的行为列表. yii\base\Component
build() Builds actual filter specification form $filter value. yii\data\DataFilter
canGetProperty() 返回一个值, 指示属性是否可读取. yii\base\Component
canSetProperty() 返回一个值, 指示属性是否可设置. yii\base\Component
className() 返回此类的完全限定名称. yii\base\BaseObject
clearErrors() Removes errors for all attributes or a single attribute. yii\base\Model
createValidators() Creates validator objects based on the validation rules specified in rules(). yii\base\Model
detachBehavior() 从组件中分离一个行为. yii\base\Component
detachBehaviors() 分离组件中的所有行为. yii\base\Component
ensureBehaviors() 确保在 behaviors() 中声明的行为已附加到此组件. yii\base\Component
extraFields() Returns the list of fields that can be expanded further and returned by toArray(). yii\base\ArrayableTrait
fields() Returns the list of fields that should be returned by default by toArray() when no specific fields are specified. yii\base\ArrayableTrait
formName() Returns the form name that this model class should use. yii\base\Model
generateAttributeLabel() Generates a user friendly attribute label based on the give attribute name. yii\base\Model
getActiveValidators() Returns the validators applicable to the current $scenario. yii\base\Model
getAttributeHint() Returns the text hint for the specified attribute. yii\base\Model
getAttributeLabel() Returns the text label for the specified attribute. yii\base\Model
getAttributes() Returns attribute values. yii\base\Model
getBehavior() 返回指定的行为对象. yii\base\Component
getBehaviors() 返回附加到此组件的所有行为. yii\base\Component
getErrorMessages() yii\data\DataFilter
getErrorSummary() Returns the errors for all attributes as a one-dimensional array. yii\base\Model
getErrors() Returns the errors for all attributes or a single attribute. yii\base\Model
getFilter() yii\data\DataFilter
getFirstError() Returns the first error of the specified attribute. yii\base\Model
getFirstErrors() Returns the first error of every attribute in the model. yii\base\Model
getIterator() Returns an iterator for traversing the attributes in the model. yii\base\Model
getScenario() Returns the scenario that this model is used in. yii\base\Model
getSearchAttributeTypes() yii\data\DataFilter
getSearchModel() yii\data\DataFilter
getValidators() Returns all the validators declared in rules(). yii\base\Model
hasErrors() Returns a value indicating whether there is any validation error. yii\base\Model
hasEventHandlers() 返回一个值, 指示是否有任何处理程序附加到指定的事件. yii\base\Component
hasMethod() 返回一个值, 指示方法是否已定义. yii\base\Component
hasProperty() 返回一个值, 指示属性是否已定义. yii\base\Component
init() 初始化对象. yii\base\BaseObject
instance() Returns static class instance, which can be used to obtain meta information. yii\base\StaticInstanceTrait
isAttributeActive() Returns a value indicating whether the attribute is active in the current scenario. yii\base\Model
isAttributeRequired() Returns a value indicating whether the attribute is required. yii\base\Model
isAttributeSafe() Returns a value indicating whether the attribute is safe for massive assignments. yii\base\Model
load() Populates the model with input data. yii\base\Model
loadMultiple() Populates a set of models with the data from end user. yii\base\Model
normalize() Normalizes filter value, replacing raw keys according to $filterControls and $attributeMap. yii\data\DataFilter
off() 从该组件分离现有的事件处理程序. yii\base\Component
offsetExists() Returns whether there is an element at the specified offset. yii\base\Model
offsetGet() Returns the element at the specified offset. yii\base\Model
offsetSet() Sets the element at the specified offset. yii\base\Model
offsetUnset() Sets the element value at the specified offset to null. yii\base\Model
on() 将事件处理程序附加到事件. yii\base\Component
onUnsafeAttribute() This method is invoked when an unsafe attribute is being massively assigned. yii\base\Model
rules() Returns the validation rules for attributes. yii\base\Model
safeAttributes() Returns the attribute names that are safe to be massively assigned in the current scenario. yii\base\Model
scenarios() Returns a list of scenarios and the corresponding active attributes. yii\base\Model
setAttributes() Sets the attribute values in a massive way. yii\base\Model
setErrorMessages() Sets the list of error messages responding to invalid filter structure, in format: [errorKey => message]. yii\data\DataFilter
setFilter() yii\data\DataFilter
setScenario() Sets the scenario for the model. yii\base\Model
setSearchAttributeTypes() yii\data\DataFilter
setSearchModel() yii\data\DataFilter
toArray() Converts the model into an array. yii\base\ArrayableTrait
trigger() 触发事件. yii\base\Component
validate() Performs the data validation. yii\base\Model
validateFilter() Validates filter attribute value to match filer condition specification. yii\data\DataFilter
validateMultiple() Validates multiple models. yii\base\Model

受保护的方法

隐藏继承的方法

方法描述定义在
buildAttributeCondition() Builds search condition for a particular attribute. yii\data\ActiveDataFilter
buildBlockCondition() Builds block condition, which consists of a single condition. yii\data\ActiveDataFilter
buildCondition() yii\data\ActiveDataFilter
buildConjunctionCondition() Builds conjunction condition, which consists of multiple independent ones. yii\data\ActiveDataFilter
buildInternal() Performs actual filter build. yii\data\ActiveDataFilter
buildOperatorCondition() Builds an operator condition. yii\data\ActiveDataFilter
defaultErrorMessages() Returns default values for $errorMessages. yii\data\DataFilter
detectSearchAttributeType() Detect attribute type from given validator. yii\data\DataFilter
detectSearchAttributeTypes() Composes default value for $searchAttributeTypes from the $searchModel validation rules. yii\data\DataFilter
extractFieldsFor() Extract nested fields from a fields collection for a given root field Nested fields are separated with dots (.). e.g: "item.id" The previous example would extract "id". yii\base\ArrayableTrait
extractRootFields() Extracts the root field names from nested fields. yii\base\ArrayableTrait
filterAttributeValue() Validates attribute value in the scope of $searchModel, applying attribute value filters if any. yii\data\DataFilter
parseErrorMessage() Parses content of the message from $errorMessages, specified by message key. yii\data\DataFilter
resolveFields() Determines which fields can be returned by toArray(). yii\base\ArrayableTrait
validateAttributeCondition() Validates search condition for a particular attribute. yii\data\DataFilter
validateAttributeValue() Validates attribute value in the scope of \yii\data\model. yii\data\DataFilter
validateBlockCondition() Validates block condition that consists of a single condition. yii\data\DataFilter
validateCondition() Validates filter condition. yii\data\DataFilter
validateConjunctionCondition() Validates conjunction condition that consists of multiple independent ones. yii\data\DataFilter
validateOperatorCondition() Validates operator condition. yii\data\DataFilter

事件

隐藏继承的事件

事件类型描述定义在
EVENT_AFTER_VALIDATE yii\base\Event An event raised at the end of validate() yii\base\Model
EVENT_BEFORE_VALIDATE yii\base\ModelEvent An event raised at the beginning of validate(). yii\base\Model

常量

隐藏继承的常量

常量描述定义在
SCENARIO_DEFAULT 'default' The name of the default scenario. yii\base\Model
TYPE_ARRAY 'array' yii\data\DataFilter
TYPE_BOOLEAN 'boolean' yii\data\DataFilter
TYPE_DATE 'date' yii\data\DataFilter
TYPE_DATETIME 'datetime' yii\data\DataFilter
TYPE_FLOAT 'float' yii\data\DataFilter
TYPE_INTEGER 'integer' yii\data\DataFilter
TYPE_STRING 'string' yii\data\DataFilter
TYPE_TIME 'time' yii\data\DataFilter

属性详情

$conditionBuilders public 属性

Maps filtering condition keywords to build methods. These methods are used by buildCondition() to build the actual filtering conditions. Particular condition builder can be specified using a PHP callback. For example:

[
    'XOR' => function (string $operator, mixed $condition) {
        //return array;
    },
    'LIKE' => function (string $operator, mixed $condition, string $attribute) {
        //return array;
    },
]
public array $conditionBuilders = ['AND' => 'buildConjunctionCondition''OR' => 'buildConjunctionCondition''NOT' => 'buildBlockCondition''<' => 'buildOperatorCondition''>' => 'buildOperatorCondition''<=' => 'buildOperatorCondition''>=' => 'buildOperatorCondition''=' => 'buildOperatorCondition''!=' => 'buildOperatorCondition''IN' => 'buildOperatorCondition''NOT IN' => 'buildOperatorCondition''LIKE' => 'buildOperatorCondition']
$queryOperatorMap public 属性

Map filtering operators to operators used in yii\db\QueryInterface::where(). The format is: [filterOperator => queryOperator]. If particular operator keyword does not appear in the map, it will be used as is.

Usually the map can be left empty as filter operator names are consistent with the ones used in yii\db\QueryInterface::where(). However, you may want to adjust it in some special cases. For example, when using PosgreSQL you may want to setup the following map:

[
    'LIKE' => 'ILIKE'
]

方法详情

buildAttributeCondition() protected 方法

Builds search condition for a particular attribute.

protected array buildAttributeCondition ( $attribute, $condition )
$attribute string

Search attribute name.

$condition mixed

Search condition.

return array

Actual condition.

buildBlockCondition() protected 方法

Builds block condition, which consists of a single condition.

It covers such operators as not.

protected array buildBlockCondition ( $operator, $condition )
$operator string

Operator keyword.

$condition mixed

Raw condition.

return array

Actual condition.

buildCondition() protected 方法

protected array buildCondition ( $condition )
$condition array
return array

Built condition.

buildConjunctionCondition() protected 方法

Builds conjunction condition, which consists of multiple independent ones.

It covers such operators as and and or.

protected array buildConjunctionCondition ( $operator, $condition )
$operator string

Operator keyword.

$condition mixed

Raw condition.

return array

Actual condition.

buildInternal() protected 方法

Performs actual filter build.

By default this method returns result of normalize(). The child class may override this method providing more specific implementation.

protected mixed buildInternal ( )
return mixed

Built actual filter value.

buildOperatorCondition() protected 方法

Builds an operator condition.

protected array buildOperatorCondition ( $operator, $condition, $attribute )
$operator string

Operator keyword.

$condition mixed

Attribute condition.

$attribute string

Attribute name.

return array

Actual condition.