Класс yii\debug\models\search\Mail
| Наследование | yii\debug\models\search\Mail » yii\debug\models\search\Base » yii\base\Model » yii\base\Component » yii\base\Object |
|---|---|
| Реализует | ArrayAccess, IteratorAggregate, yii\base\Arrayable, yii\base\Configurable |
| Используемые трейты | yii\base\ArrayableTrait |
| Доступно с версии | 2.0 |
| Исходный код | https://github.com/yiisoft/yii2-debug/blob/master/models/search/Mail.php |
Mail представляет модель, лежащую в основе формы поиска текущих отправленных писем.
Публичные свойства
| Свойство | Тип | Описание | Определено в |
|---|---|---|---|
| $activeValidators | yii\validators\Validator[] | Валидаторы, применимые к текущему $scenario. | yii\base\Model |
| $attributes | массив | Значения атрибутов (имя => значение). | yii\base\Model |
| $bcc | строка | Значение поиска по атрибуту BCC | yii\debug\models\search\Mail |
| $behaviors | yii\base\Behavior[] | Список прикреплённых к данному компоненту поведений | yii\base\Component |
| $body | строка | Значение поиска по атрибуту Тело | yii\debug\models\search\Mail |
| $cc | строка | Значение поиска по атрибуту Копия | yii\debug\models\search\Mail |
| $charset | строка | Значение поиска по атрибуту Кодировка | yii\debug\models\search\Mail |
| $errors | массив | Ошибки для всех атрибутов или указанного атрибута. | yii\base\Model |
| $file | строка | Значение поиска по атрибуту Файл | yii\debug\models\search\Mail |
| $firstErrors | массив | Первые ошибки. | yii\base\Model |
| $from | строка | Значение поиска по атрибуту От | yii\debug\models\search\Mail |
| $headers | строка | Значение поиска по атрибуту Заголовки | yii\debug\models\search\Mail |
| $iterator | ArrayIterator | Итератор для обхода элементов в списке. | yii\base\Model |
| $reply | строка | Значение поиска по атрибуту Ответ | yii\debug\models\search\Mail |
| $scenario | строка | Сценарий, в котором находится эта модель. | yii\base\Model |
| $subject | строка | Значение поиска по атрибуту Тема | yii\debug\models\search\Mail |
| $to | строка | Значение поиска по атрибуту Получателям | yii\debug\models\search\Mail |
| $validators | ArrayObject|yii\validators\Validator[] | Все объявленные в модели валидаторы. | yii\base\Model |
Публичные методы
| Метод | Описание | Определено в |
|---|---|---|
| __call() | Вызывает именованный метод, который не является методом класса. | yii\base\Object |
| __clone() | Этот метод вызывается после создания объекта путём клонирования существующего. | yii\base\Component |
| __construct() | Конструктор. | yii\base\Object |
| __get() | Возвращает значение свойства объекта. | yii\base\Object |
| __isset() | Проверяет, установлено ли свойство, т.е. определено и не равно null. | yii\base\Object |
| __set() | Устанавливает значение свойства объекта. | yii\base\Object |
| __unset() | Устанавливает свойство объекта в значение null. | yii\base\Object |
| activeAttributes() | Возвращает имена атрибутов, которые подлежат валидации в текущей ситуации. | yii\base\Model |
| addCondition() | Добавляет условие фильтрации для заданного атрибута | yii\debug\models\search\Base |
| addError() | Добавляет новую ошибку к указанному атрибуту. | yii\base\Model |
| addErrors() | Добавляет список ошибок. | yii\base\Model |
| afterValidate() | Этот метод вызывается после завершения валидации. | yii\base\Model |
| attachBehavior() | Присоединяет поведение к данному компоненту. | yii\base\Component |
| attachBehaviors() | Присоединяет список поведений к компоненту. | yii\base\Component |
| attributeHints() | Возвращает подсказки к атрибутам. | yii\base\Model |
| attributeLabels() | Возвращает метки атрибутов. | yii\debug\models\search\Mail |
| attributes() | Возвращает список имён атрибутов. | yii\base\Model |
| beforeValidate() | Этот метод вызывается перед началом валидации. | yii\base\Model |
| behaviors() | Возвращает список поведений, которые должен иметь этот компонент. | yii\base\Component |
| canGetProperty() | Возвращает значение, указывающее, можно ли считать свойство. | yii\base\Object |
| canSetProperty() | Возвращает значение, указывающее, можно ли установить свойство. | yii\base\Object |
| className() | Возвращает полное квалифицированное имя этого класса. | yii\base\Object |
| clearErrors() | Удаляет ошибки для всех атрибутов или одного атрибута. | yii\base\Model |
| createValidators() | Создаёт объекты валидаторов на основе правил валидации, указанных в rules(). | yii\base\Model |
| detachBehavior() | Отсоединяет поведение от компонента. | yii\base\Component |
| detachBehaviors() | Отсоединяет все поведения от компонента. | yii\base\Component |
| ensureBehaviors() | Убеждается, что поведения, объявленные в behaviors(), присоединены к данному компоненту. | yii\base\Component |
| extraFields() | Возвращает список полей, которые могут быть расширены и возвращены функцией toArray(). | yii\base\ArrayableTrait |
| fields() | Возвращает список полей, которые по умолчанию должны быть возвращены функцией toArray(), когда не указаны конкретные поля. | yii\base\ArrayableTrait |
| formName() | Возвращает имя формы, которое должен использовать этот класс модели. | yii\base\Model |
| generateAttributeLabel() | Генерирует понятную пользователю метку атрибута на основе данного имени атрибута. | yii\base\Model |
| getActiveValidators() | Возвращает валидаторы, применимые к текущей $scenario. | yii\base\Model |
| getAttributeHint() | Возвращает текстовую подсказку для указанного атрибута. | yii\base\Model |
| getAttributeLabel() | Возвращает текстовую метку для указанного атрибута. | yii\base\Model |
| getAttributes() | Возвращает значения атрибутов. | yii\base\Model |
| getBehavior() | Возвращает объект именованного поведения. | yii\base\Component |
| getBehaviors() | Возвращает все присоединенные к этому компоненту поведения. | yii\base\Component |
| getErrors() | Возвращает ошибки для всех атрибутов или одного атрибута. | yii\base\Model |
| getFirstError() | Возвращает первую ошибку указанного атрибута. | yii\base\Model |
| getFirstErrors() | Возвращает первую ошибку каждого атрибута в модели. | yii\base\Model |
| getIterator() | Возвращает итератор для обхода атрибутов в модели. | yii\base\Model |
| getScenario() | Возвращает сценарий, в котором используется эта модель. | yii\base\Model |
| getValidators() | Возвращает все валидаторы, объявленные в rules(). | yii\base\Model |
| hasErrors() | Возвращает значение, указывающее, есть ли ошибки валидации. | yii\base\Model |
| hasEventHandlers() | Возвращает значение, указывающее, есть ли обработчик, привязанный к указанному событию. | yii\base\Component |
| hasMethod() | Возвращает значение, указывающее, определён ли метод. | yii\base\Object |
| hasProperty() | Возвращает значение, указывающее, определено ли свойство. | yii\base\Object |
| init() | Инициализирует объект. | yii\base\Object |
| isAttributeActive() | Возвращает значение, указывающее, активен ли атрибут в текущем сценарии. | yii\base\Model |
| isAttributeRequired() | Возвращает значение, указывающее, обязателен ли атрибут. | yii\base\Model |
| isAttributeSafe() | Возвращает значение, указывающее, является ли атрибут безопасным для массовых назначений. | yii\base\Model |
| load() | Заполняет модель входными данными. | yii\base\Model |
| loadMultiple() | Заполняет набор моделей данными от конечного пользователя. | yii\base\Model |
| off() | Отсоединяет существующий обработчик событий от этого компонента. | yii\base\Component |
| offsetExists() | Возвращает, существует ли элемент по указанному смещению. | yii\base\Model |
| offsetGet() | Возвращает элемент по указанному смещению. | yii\base\Model |
| offsetSet() | Устанавливает элемент по указанному смещению. | yii\base\Model |
| offsetUnset() | Устанавливает значение элемента по указанному смещению в null. | yii\base\Model |
| on() | Присоединяет обработчик событий к событию. | yii\base\Component |
| onUnsafeAttribute() | Этот метод вызывается, когда небезопасный атрибут назначается массово. | yii\base\Model |
| rules() | Возвращает правила валидации для атрибутов. | yii\debug\models\search\Mail |
| safeAttributes() | Возвращает имена атрибутов, которые безопасно назначать массово в текущем сценарии. | yii\base\Model |
| scenarios() | Возвращает список сценариев и соответствующие активные атрибуты. | yii\base\Model |
| search() | Возвращает поставщик данных с заполненными моделями. При необходимости применяется фильтр. | yii\debug\models\search\Mail |
| setAttributes() | Устанавливает значения атрибутов массовым способом. | yii\base\Model |
| setScenario() | Устанавливает сценарий для модели. | yii\base\Model |
| toArray() | Преобразует модель в массив. | yii\base\ArrayableTrait |
| trigger() | Вызывает событие. | yii\base\Component |
| validate() | Выполняет проверку данных. | yii\base\Model |
| validateMultiple() | Проверяет несколько моделей. | yii\base\Model |
Защищенные методы
| Метод | Описание | Определено |
|---|---|---|
| resolveFields() | Определяет, какие поля могут быть возвращены методом toArray(). | yii\base\ArrayableTrait |
События
| Событие | Тип | Описание | Определено |
|---|---|---|---|
| EVENT_AFTER_VALIDATE | yii\base\Event | Событие, генерируемое в конце validate() | yii\base\Model |
| EVENT_BEFORE_VALIDATE | yii\base\ModelEvent | Событие, генерируемое в начале validate(). | yii\base\Model |
Константы
| Константа | Значение | Описание | Определено |
|---|---|---|---|
| SCENARIO_DEFAULT | 'default' | Название по умолчанию сценария. | yii\base\Model |
Подробное описание свойств
$bcc общедоступное свойство
Значение ввода поиска атрибута BCC
public string $bcc = null
$body общедоступное свойство
Значение ввода поиска атрибута Body
public string $body = null
$cc общедоступное свойство
Значение ввода поиска атрибута CC
public string $cc = null
$charset общедоступное свойство
Значение ввода поиска атрибута Charset
public string $charset = null
$file общедоступное свойство
Значение ввода поиска атрибута File
public string $file = null
$from общедоступное свойство
Значение ввода поиска атрибута From
public string $from = null
$headers общедоступное свойство
Значение ввода поиска атрибута Headers
public string $headers = null
$reply общедоступное свойство
Значение ввода поиска атрибута Reply
public string $reply = null
$subject общедоступное свойство
Значение ввода поиска атрибута Subject
public string $subject = null
$to общедоступное свойство
Значение ввода поиска атрибута To
public string $to = null
Подробное описание методов
attributeLabels() public method
Возвращает метки атрибутов.
Метки атрибутов используются в основном для отображения. Например, для атрибута firstName, мы можем объявить более удобную для пользователя метку First Name, которую можно отобразить конечным пользователям.
По умолчанию метка атрибута генерируется с помощью generateAttributeLabel(). Этот метод позволяет явно указать метки атрибутов.
Обратите внимание, что для наследования меток, определённых в родительском классе, дочерний класс должен объединить родительские метки с дочерними метками, используя функции, такие как array_merge().
| public массив attributeLabels ( ) | ||
|---|---|---|
| return | массив |
Метки атрибутов (имя => метка) |
rules() public method
Возвращает правила валидации для атрибутов.
Правила валидации используются методом validate() для проверки корректности значений атрибутов. Дочерние классы могут переопределить этот метод, чтобы объявить разные правила валидации.
Каждое правило представляет собой массив со следующей структурой:
[
['attribute1', 'attribute2'],
'validator type',
'on' => ['scenario1', 'scenario2'],
//...other parameters...
]
где
- список атрибутов: обязательный, задаёт массив атрибутов, которые нужно валидировать, для одного атрибута можно передать строку;
- тип валидатора: обязательный, задаёт валидатор, который нужно использовать. Это может быть встроенное имя валидатора, имя метода класса модели, анонимная функция или имя класса валидатора.
- on: необязательный, задаёт массив сценариев, в которых правило валидации может применяться. Если этот параметр не задан, правило будет применяться ко всем сценариям.
- дополнительные пары имя-значение могут быть указаны для инициализации соответствующих свойств валидатора. Обратитесь к API отдельного класса валидатора для возможных свойств.
Валидатор может быть либо объектом класса, расширяющего \yii\debug\models\search\Validator, либо методом класса модели (так называемый встроенный валидатор), имеющим следующий синтаксис:
// $params refers to validation parameters given in the rule function validatorName($attribute, $params)
В приведенном выше примере $attribute относится к атрибуту, который в данный момент валидируется, а $params содержит массив параметров конфигурации валидатора, таких как max в случае валидатора string. Значение атрибута, который в данный момент валидируется, можно получить как $this->$attribute. Обратите внимание на $ перед attribute; это используется значение переменной $attribute в качестве имени свойства для доступа.
Yii также предоставляет набор встроенных валидаторов \yii\debug\models\search\Validator::builtInValidators. Каждый из них имеет псевдоним, который можно использовать при указании правила валидации.
Ниже приведены несколько примеров:
[
// built-in "required" validator
[['username', 'password'], 'required'],
// built-in "string" validator customized with "min" and "max" properties
['username', 'string', 'min' => 3, 'max' => 12],
// built-in "compare" validator that is used in "register" scenario only
['password', 'compare', 'compareAttribute' => 'password2', 'on' => 'register'],
// an inline validator defined via the "authenticate()" method in the model class
['password', 'authenticate', 'on' => 'login'],
// a validator of class "DateRangeValidator"
['dateRange', 'DateRangeValidator'],
];
Обратите внимание, что для наследования правил, определённых в родительском классе, дочерний класс должен объединить родительские правила с дочерними правилами, используя функции, такие как array_merge().
| public массив rules ( ) | ||
|---|---|---|
| return | массив |
Правила валидации |
search() public method
Возвращает поставщик данных с заполненными моделями. При необходимости применяется фильтр.
| public yii\data\ArrayDataProvider search ( $params, $models ) | ||
|---|---|---|
| $params | массив | |
| $models | массив | |
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc-2.0/yii-debug-models-search-mail.html