Spec-Zone.ru › Yii 2.0

Класс 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API