Spec-Zone.ru › Yii 2.0

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

Spec-Zone.ru

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