Base
API reference › Debug › models › search › Base
5 subclasses
Bridges Yii2 search-model attributes to the shared framework-neutral filter engine.
Properties
Section titled “Properties”| Property | Type | Description | Defined by |
|---|---|---|---|
$activeValidators read-only | yii\[] | The validators applicable to the current $scenario. | yii\ |
$attributes | array<string, | Attribute values (name => value). | yii\ |
$behaviors read-only | array<yii\<static>> | List of behaviors attached to this component. | yii\ |
$errors read-only | array<string, | Errors for all attributes. | yii\ |
$firstErrors read-only | array<string, | The first errors. | yii\ |
$iterator read-only | ArrayIterator<string, | An iterator for traversing the items in the list. | yii\ |
$scenario | string | The scenario that this model is in. | yii\ |
$validators read-only | ArrayObject<int, yii\>|yii\[] | All the validators declared in the model. | yii\ |
Methods
Section titled “Methods”| Method | Description | Defined by |
|---|---|---|
__construct() | Constructor. | yii\ |
__call() | Calls the named method which is not a class method. | yii\ |
__clone() | This method is called after the object is created by cloning an existing one. | yii\ |
__get() | Returns the value of a component property. | yii\ |
__isset() | Checks if a property is set, i.e. defined and not null. | yii\ |
__set() | Sets the value of a component property. | yii\ |
__unset() | Sets a component property to be null. | yii\ |
activeAttributes() | Returns the attribute names that are subject to validation in the current scenario. | yii\ |
addError() | Adds a new error to the specified attribute. | yii\ |
addErrors() | Adds a list of errors. | yii\ |
afterValidate() | This method is invoked after validation ends. | yii\ |
attachBehavior() | Attaches a behavior to this component. | yii\ |
attachBehaviors() | Attaches a list of behaviors to the component. | yii\ |
attributeHints() | Returns the attribute hints. | yii\ |
attributeLabels() | Returns the attribute labels. | yii\ |
attributes() | Returns the list of attribute names. | yii\ |
beforeValidate() | This method is invoked before validation starts. | yii\ |
behaviors() | Returns a list of behaviors that this component should behave as. | yii\ |
canGetProperty() | Returns a value indicating whether a property can be read. | yii\ |
canSetProperty() | Returns a value indicating whether a property can be set. | yii\ |
className() static | Returns the fully qualified name of this class. | yii\ |
clearErrors() | Removes errors for all attributes or a single attribute. | yii\ |
createValidators() | Creates validator objects based on the validation rules specified in rules(). | yii\ |
detachBehavior() | Detaches a behavior from the component. | yii\ |
detachBehaviors() | Detaches all behaviors from the component. | yii\ |
ensureBehaviors() | Makes sure that the behaviors declared in behaviors() are attached to this component. | yii\ |
extraFields() | Returns the list of fields that can be expanded further and returned by toArray(). | yii\ |
fields() | Returns the list of fields that should be returned by default by toArray() when no specific fields are specified. | yii\ |
formName() | Returns the form name that this model class should use. | yii\ |
generateAttributeLabel() | Generates a user friendly attribute label based on the give attribute name. | yii\ |
getActiveValidators() | Returns the validators applicable to the current $scenario. | yii\ |
getAttributeHint() | Returns the text hint for the specified attribute. | yii\ |
getAttributeLabel() | Returns the text label for the specified attribute. | yii\ |
getAttributes() | Returns attribute values. | yii\ |
getBehavior() | Returns the named behavior object. | yii\ |
getBehaviors() | Returns all behaviors attached to this component. | yii\ |
getErrors() | Returns the errors for all attributes or a single attribute. | yii\ |
getErrorSummary() | Returns the errors for all attributes as a one-dimensional array. | yii\ |
getFirstError() | Returns the first error of the specified attribute. | yii\ |
getFirstErrors() | Returns the first error of every attribute in the model. | yii\ |
getIterator() | Returns an iterator for traversing the attributes in the model. | yii\ |
getScenario() | Returns the scenario that this model is used in. | yii\ |
getValidators() | Returns all the validators declared in rules(). | yii\ |
hasErrors() | Returns a value indicating whether there is any validation error. | yii\ |
hasEventHandlers() | Returns a value indicating whether there is any handler attached to the named event. | yii\ |
hasMethod() | Returns a value indicating whether a method is defined. | yii\ |
hasProperty() | Returns a value indicating whether a property is defined for this component. | yii\ |
init() | Initializes the object. | yii\ |
instance() static | Returns static class instance, which can be used to obtain meta information. | yii\ |
isAttributeActive() | Returns a value indicating whether the attribute is active in the current scenario. | yii\ |
isAttributeRequired() | Returns a value indicating whether the attribute is required. | yii\ |
isAttributeSafe() | Returns a value indicating whether the attribute is safe for massive assignments. | yii\ |
load() | Populates the model with input data. | yii\ |
loadMultiple() static | Populates a set of models with the data from end user. | yii\ |
off() | Detaches an existing event handler from this component. | yii\ |
offsetExists() | Returns whether there is an element at the specified offset. | yii\ |
offsetGet() | Returns the element at the specified offset. | yii\ |
offsetSet() | Sets the element at the specified offset. | yii\ |
offsetUnset() | Sets the element value at the specified offset to null. | yii\ |
on() | Attaches an event handler to an event. | yii\ |
onUnsafeAttribute() | This method is invoked when an unsafe attribute is being massively assigned. | yii\ |
rules() | Returns the validation rules for attributes. | yii\ |
safeAttributes() | Returns the attribute names that are safe to be massively assigned in the current scenario. | yii\ |
scenarios() | Returns a list of scenarios and the corresponding active attributes. | yii\ |
setAttributes() | Sets the attribute values in a massive way. | yii\ |
setScenario() | Sets the scenario for the model. | yii\ |
toArray() | Converts the model into an array. | yii\ |
trigger() | Triggers an event. | yii\ |
validate() | Performs the data validation. | yii\ |
validateMultiple() static | Validates multiple models. | yii\ |
addCondition() protected | Registers an exact, partial, or leading numeric comparison condition. | Base |
addMinimumCondition() protected | Registers a numeric greater-than-or-equal condition. | Base |
extractFieldsFor() protected | 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\ |
extractRootFields() protected | Extracts the root field names from nested fields. | yii\ |
filter() protected | Applies all registered conditions. | Base |
resolveFields() protected | Determines which fields can be returned by toArray(). | yii\ |
Events
Section titled “Events”| Event | Type | Description | Defined by |
|---|---|---|---|
EVENT_BEFORE_VALIDATE | yii\ | An event raised at the beginning of validate(). Event name: 'beforeValidate'. | yii\ |
EVENT_AFTER_VALIDATE | yii\ | An event raised at the end of validate() Event name: 'afterValidate'. | yii\ |
Constants
Section titled “Constants”| Constant | Value | Description | Defined by |
|---|---|---|---|
SCENARIO_DEFAULT | 'default' | The name of the default scenario. | yii\ |
Method details
Section titled “Method details”addCondition()
Section titled “addCondition() ”protected function addCondition(string $attribute, bool $partial = false): voidRegisters an exact, partial, or leading numeric comparison condition.
Parameters
| Parameter | Type | Description |
|---|---|---|
$attribute | string | Attribute supplying the filter value and naming the row key to compare. |
$partial | bool | Whether to match the value as a substring instead of requiring equality. |
addMinimumCondition()
Section titled “addMinimumCondition() ”protected function addMinimumCondition(string $attribute, float $value): voidRegisters a numeric greater-than-or-equal condition.
Parameters
| Parameter | Type | Description |
|---|---|---|
$attribute | string | Attribute naming the row key to compare. |
$value | float | Inclusive lower bound the row value must reach. |
filter()
Section titled “filter() ”protected function filter(array<int, yii\debug\models\search\TRow> $rows): list<yii\debug\models\search\TRow>Applies all registered conditions.
Parameters
| Parameter | Type | Description |
|---|---|---|
$rows | array<int, | Rows to filter; typed row objects or string-keyed arrays. |
Returns
list<yii\debug\models\search\TRow>: Rows matching every registered condition, reindexed.