Класс yii\gii\generators\module\Generator
| Наследование | yii\gii\generators\module\Generator » yii\gii\Generator » 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-gii/blob/master/generators/module/Generator.php |
Этот генератор сгенерирует необходимый шаблонный код для модуля.
Публичные свойства
| Свойство | Тип | Описание | Определено в |
|---|---|---|---|
| $activeValidators | yii\validators\Validator[] | Валидаторы, применимые к текущему $сценарий. | yii\base\Model |
| $attributes | массив | Значения атрибутов (имя => значение). | yii\base\Model |
| $behaviors | yii\base\Behavior[] | Список присоединённых к этому компоненту поведений. | yii\base\Component |
| $controllerNamespace | строка | Пространство имён контроллера модуля. | yii\gii\generators\module\Generator |
| $description | строка | Подробное описание генератора. | yii\gii\generators\module\Generator |
| $enableI18N | булево | Будет ли использоваться Yii::t() или обычные строки. | yii\gii\Generator |
| $errors | массив | Ошибки для всех атрибутов или указанного атрибута. | yii\base\Model |
| $firstErrors | массив | Первые ошибки. | yii\base\Model |
| $iterator | ArrayIterator | Итератор для обхода элементов в списке. | yii\base\Model |
| $messageCategory | строка | Категория сообщений, используемая Yii::t(), когда $enableI18N является true. | yii\gii\Generator |
| $moduleClass | yii\gii\generators\module\Generator | ||
| $moduleID | yii\gii\generators\module\Generator | ||
| $modulePath | булево | Директория, содержащая класс модуля | yii\gii\generators\module\Generator |
| $name | строка | Имя генератора кода | yii\gii\generators\module\Generator |
| $сценарий | строка | Сценарий, в котором находится эта модель. | yii\base\Model |
| $stickyDataFile | строка | Путь к файлу, хранящему значения атрибутов. | yii\gii\Generator |
| $template | строка | Имя выбранной шаблона кода. | yii\gii\Generator |
| $templatePath | строка | Корневой путь к файлам шаблонов, которые используются в данный момент. | yii\gii\Generator |
| $templates | массив | Список доступных шаблонов кода. | yii\gii\Generator |
| $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 |
| 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\gii\generators\module\Generator |
| attributes() | Возвращает список имён атрибутов. | yii\base\Model |
| autoCompleteData() | Возвращает список значений автозаполнения. | yii\gii\Generator |
| 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 |
| defaultTemplate() | Возвращает путь к корневым файлам шаблонов по умолчанию. | yii\gii\Generator |
| 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 |
| formView() | Возвращает файл представления для формы ввода генератора. | yii\gii\Generator |
| generate() | Генерирует код на основе текущего ввода пользователя и указанных файлов шаблонов кода. | yii\gii\generators\module\Generator |
| generateAttributeLabel() | Генерирует понятную метку атрибута на основе имени атрибута. | yii\base\Model |
| generateString() | Генерирует строку в зависимости от свойства enableI18N. | yii\gii\Generator |
| 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 |
| getControllerNamespace() | yii\gii\generators\module\Generator | |
| getDescription() | yii\gii\generators\module\Generator | |
| getErrors() | Возвращает ошибки для всех атрибутов или одного атрибута. | yii\base\Model |
| getFirstError() | Возвращает первую ошибку указанного атрибута. | yii\base\Model |
| getFirstErrors() | Возвращает первую ошибку каждого атрибута в модели. | yii\base\Model |
| getIterator() | Возвращает итератор для обхода атрибутов в модели. | yii\base\Model |
| getModulePath() | yii\gii\generators\module\Generator | |
| getName() | yii\gii\generators\module\Generator | |
| getScenario() | Возвращает сценарий, в котором используется эта модель. | yii\base\Model |
| getStickyDataFile() | yii\gii\Generator | |
| getTemplatePath() | yii\gii\Generator | |
| getValidators() | Возвращает все валидаторы, объявленные в rules(). | yii\base\Model |
| hasErrors() | Возвращает значение, указывающее, есть ли какие-либо ошибки валидации. | yii\base\Model |
| hasEventHandlers() | Возвращает значение, указывающее, прикреплен ли какой-либо обработчик к указанному событию. | yii\base\Component |
| hasMethod() | Возвращает значение, указывающее, определен ли метод. | yii\base\Object |
| hasProperty() | Возвращает значение, указывающее, определено ли свойство. | yii\base\Object |
| hints() | Возвращает список сообщений подсказок. | yii\gii\generators\module\Generator |
| init() | Инициализирует объект. | yii\gii\Generator |
| isAttributeActive() | Возвращает значение, указывающее, активен ли атрибут в текущем сценарии. | yii\base\Model |
| isAttributeRequired() | Возвращает значение, указывающее, обязателен ли атрибут. | yii\base\Model |
| isAttributeSafe() | Возвращает значение, указывающее, является ли атрибут безопасным для массового присваивания. | yii\base\Model |
| isReservedKeyword() | yii\gii\Generator | |
| load() | Заполняет модель данными ввода. | yii\base\Model |
| loadMultiple() | Заполняет набор моделей данными от пользователя. | yii\base\Model |
| loadStickyAttributes() | Загружает закрепленные атрибуты из внутреннего файла и заполняет ими генератор. | yii\gii\Generator |
| 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 |
| render() | Генерирует код, используя указанную шаблон и параметры. | yii\gii\Generator |
| requiredTemplates() | Возвращает список файлов шаблонов кода, которые необходимы. | yii\gii\generators\module\Generator |
| rules() | Возвращает правила валидации для атрибутов. | yii\gii\generators\module\Generator |
| safeAttributes() | Возвращает имена атрибутов, которые безопасны для массового присваивания в текущем сценарии. | yii\base\Model |
| save() | Сохраняет сгенерированный код в файлы. | yii\gii\Generator |
| saveStickyAttributes() | Сохраняет закрепленные атрибуты во внутренний файл. | yii\gii\Generator |
| scenarios() | Возвращает список сценариев и соответствующих активных атрибутов. | yii\base\Model |
| setAttributes() | Устанавливает значения атрибутов массовым способом. | yii\base\Model |
| setScenario() | Устанавливает сценарий для модели. | yii\base\Model |
| stickyAttributes() | Возвращает список закрепленных атрибутов. | yii\gii\Generator |
| successMessage() | Возвращает сообщение, которое будет отображаться при успешном сохранении сгенерированного кода. | yii\gii\generators\module\Generator |
| toArray() | Преобразует модель в массив. | yii\base\ArrayableTrait |
| trigger() | Вызывает событие. | yii\base\Component |
| validate() | Выполняет валидацию данных. | yii\base\Model |
| validateClass() | Встроенный валидатор, проверяющий, ссылается ли значение атрибута на имя существующего класса. | yii\gii\Generator |
| validateMessageCategory() | Проверяет, не пуста ли категория сообщений, когда включена I18N. | yii\gii\Generator |
| validateModuleClass() | Проверяет $moduleClass для того, чтобы убедиться, что это полное имя класса. | yii\gii\generators\module\Generator |
| validateMultiple() | Проверяет несколько моделей. | yii\base\Model |
| validateNewClass() | Встроенный валидатор, проверяющий, относится ли значение атрибута к имени класса с именем пространства имен. | yii\gii\Generator |
| validateTemplate() | Проверяет выбор шаблона. | yii\gii\Generator |
Защищенные методы
| Метод | Описание | Определен в |
|---|---|---|
| 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 |
Подробное описание свойств
$controllerNamespace открытое только для чтения свойство
Пространство имён контроллера модуля.
public string getControllerNamespace ( )
$description открытое только для чтения свойство
Подробное описание генератора.
public string getDescription ( )
$moduleClass открытое свойство
public $moduleClass = null $moduleID открытое свойство
public $moduleID = null $modulePath открытое только для чтения свойство
Директория, содержащая класс модуля
public boolean getModulePath ( )
$name открытое только для чтения свойство
Имя генератора кода
public string getName ( )
Подробное описание методов
attributeLabels() открытый метод
Возвращает метки атрибутов.
Метки атрибутов в основном используются для отображения. Например, при наличии атрибута firstName, мы можем объявить метку First Name, которая более удобна для пользователя и может быть отображена конечным пользователям.
По умолчанию метка атрибута генерируется с помощью generateAttributeLabel(). Этот метод позволяет явно указать метки атрибутов.
Обратите внимание, для наследования меток, определенных в родительском классе, дочерний класс должен объединить родительские метки с дочерними, используя функции, такие как array_merge().
| public array attributeLabels ( ) | ||
|---|---|---|
| return | array |
Метки атрибутов (имя => метка) |
generate() открытый метод
Генерирует код на основе текущего пользовательского ввода и указанных шаблонов файлов кода.
Это основной метод, который должны реализовывать дочерние классы. Обратитесь к yii\gii\generators\controller\Generator::generate() в качестве примера реализации этого метода.
| public yii\gii\CodeFile[] generate ( ) | ||
|---|---|---|
| return | yii\gii\CodeFile[] |
Список файлов кода, которые будут созданы. |
getControllerNamespace() открытый метод
| public string getControllerNamespace ( ) | ||
|---|---|---|
| return | string |
Пространство имён контроллера модуля. |
getDescription() открытый метод
| public string getDescription ( ) | ||
|---|---|---|
| return | string |
Подробное описание генератора. |
getModulePath() открытый метод
| public boolean getModulePath ( ) | ||
|---|---|---|
| return | boolean |
Директория, содержащая класс модуля |
getName() открытый метод
| public string getName ( ) | ||
|---|---|---|
| return | string |
Имя генератора кода |
hints() открытый метод
Возвращает список сообщений подсказок.
Ключами массива являются имена атрибутов, а значениями — соответствующие сообщения подсказок. Сообщения подсказок будут отображаться конечным пользователям при заполнении формы генератора.
| public array hints ( ) | ||
|---|---|---|
| return | array |
Список сообщений подсказок |
requiredTemplates() открытый метод
Возвращает список файлов шаблонов кода, которые требуются.
Производные классы обычно должны переопределять этот метод, если они требуют существования определенных файлов шаблонов.
| public array requiredTemplates ( ) | ||
|---|---|---|
| return | array |
Список файлов шаблонов кода, которые требуются. Они должны быть путями к файлам относительно $templatePath. |
rules() открытый метод
Возвращает правила проверки для атрибутов.
Правила проверки используются методом validate() для проверки допустимости значений атрибутов. Дочерние классы могут переопределять этот метод для объявления различных правил проверки.
Каждое правило — массив следующей структуры:
[
['attribute1', 'attribute2'],
'validator type',
'on' => ['scenario1', 'scenario2'],
//...other parameters...
]
где
- список атрибутов: обязательный, определяет массив атрибутов, которые необходимо проверить, для одного атрибута можно передать строку;
- тип валидатора: обязательный, определяет используемый валидатор. Это может быть встроенное имя валидатора, имя метода класса модели, анонимная функция или имя класса валидатора.
- on: необязательный, определяет массив сценариев, в которых может применяться правило проверки. Если этот параметр не задан, правило будет применяться ко всем сценариям.
- дополнительные пары имя-значение могут быть указаны для инициализации соответствующих свойств валидатора. Обратитесь к API отдельных классов валидаторов для возможных свойств.
Валидатор может быть либо объектом класса, расширяющего \yii\gii\generators\module\Validator, либо методом класса модели (называемый встроенным валидатором), имеющим следующий синтаксис:
// $params refers to validation parameters given in the rule function validatorName($attribute, $params)
В приведенном выше примере $attribute относится к атрибуту, который в данный момент проверяется, а $params содержит массив параметров конфигурации валидатора, таких как max в случае валидатора string. Значение атрибута, который в данный момент проверяется, можно получить как $this->$attribute. Обратите внимание на $ перед attribute; это использует значение переменной $attribute в качестве имени свойства для доступа.
Yii также предоставляет набор \yii\gii\generators\module\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().
Дочерние классы должны переопределять этот метод следующим образом, чтобы включить родительские правила:
return array_merge(parent::rules(), [
...rules for the child class...
]);
| public array rules ( ) | ||
|---|---|---|
| return | array |
Правила проверки |
successMessage() открытый метод
Возвращает сообщение, которое будет отображено при успешном сохранении сгенерированного кода.
Дочерние классы могут переопределять этот метод для настройки сообщения.
| public string successMessage ( ) | ||
|---|---|---|
| return | string |
Сообщение, которое будет отображено при успешном сохранении сгенерированного кода. |
validateModuleClass() открытый метод
Проверяет $moduleClass, чтобы убедиться, что это полностью квалифицированное имя класса.
| public void validateModuleClass ( ) |
|---|
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc-2.0/yii-gii-generators-module-generator.html