diff --git a/docs/guide-ru/start-gii.md b/docs/guide-ru/start-gii.md index 495b83a..5fc4b3f 100644 --- a/docs/guide-ru/start-gii.md +++ b/docs/guide-ru/start-gii.md @@ -1,22 +1,22 @@ Генерация кода при помощи Gii ======================== -В этом разделе, мы опишем как использовать [Gii](tool-gii.md) для автоматической генерации кода -реализующий некоторые общие особенности. Для достижения этой цели, все что вам нужно это просто ввести необходимую информацию в соответствии с инструкциями отображаемыми на веб-страницах Gii. +В этом разделе мы опишем, как использовать [Gii](tool-gii.md) для автоматической генерации кода, +реализующего некоторые общие функции вебсайта. Для достижения этой цели всё, что вам нужно, это просто ввести необходимую информацию в соответствии с инструкциями, отображаемыми на веб-страницах Gii. -В этом руководстве, вы узнаете +В этом руководстве вы узнаете: -* Как включить Gii в приложении; +* Как активировать Gii в приложении; * Как использовать Gii для создания Active Record класса; * Как использовать Gii для генерации кода, реализующего CRUD для таблицы БД. -* Как настроить код генерируемый Gii. +* Как настроить код, генерируемый Gii. Запускаем Gii <a name="starting-gii"></a> ------------ -[Gii](tool-gii.md) поставляется в Yii как [модуль](structure-modules.md). Вы можете включить Gii -настроив его свойство [[yii\base\Application::modules|modules]] приложения. В частности, вы можете найти следующий код уже приведен в `config/web.php` файле - настройки приложения, +[Gii](tool-gii.md) предствален в Yii как [модуль](structure-modules.md). Вы можете активировать Gii, +настроив его в свойстве [[yii\base\Application::modules|modules]]. В зависимости от того, каким образом вы создали приложение, вы можете удостовериться в наличии следующего кода в конфигурационном файле `config/web.php`, ```php $config = [ ... ]; @@ -27,92 +27,100 @@ if (YII_ENV_DEV) { } ``` -Приведенная выше конфигурация показывает, что когда в [среде разработки](concept-configurations.md#environment-constants), +Приведенная выше конфигурация показывает, что находясь в [режиме разработки](concept-configurations.md#environment-constants), приложение должно включать в себя модуль с именем `gii`, который реализует класс [[yii\gii\Module]]. -Если вы проверите [входной скрипт](structure-entry-scripts.md) `web/index.php` вашего приложения, вы -найдете следующую строку, которая по сути делает `YII_ENV_DEV`, чтобы быть правдой. +Если вы посмотрите [входной скрипт](structure-entry-scripts.md) `web/index.php` вашего приложения, вы +увидите следующую строку, устанавливающую константу `YII_ENV_DEV` в значение `true`. ```php defined('YII_ENV') or define('YII_ENV', 'dev'); ``` -Благодаря этой строке, ваше приложение находится в режиме разработки, и Gii будет уже включен, в соответствии с описанной выше конфигурации. Теперь вы можете получить доступ к Gii по следующему адресу: +Благодаря этой строке ваше приложение находится в режиме разработки, и Gii уже активирован в соответствии с описанной выше конфигурацией. Теперь вы можете получить доступ к Gii по следующему адресу: ``` http://hostname/index.php?r=gii ``` +> Замечание: Если вы пытаетесь получить доступ к Gii не с локального хоста, по умолчанию, в целях обеспечения безопасности, +> доступ будет запрещён. Вы можете изменить настройки Gii, чтобы добавить разрешённые IP адреса, как указано ниже +```php +'gii' => [ + 'class' => 'yii\gii\Module', + 'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'] // регулируйте в соответствии со своими нуждами +], +```  Генерация класса Active Record <a name="generating-ar"></a> --------------------------------- -Для использования Gii генератора класса Active Record, выберите "Генератор модели" (нажав на ссылку на главной странице Gii). И заполните форму следующим образом: +Чтобы использовать Gii для генерации класса Active Record, выберите "Генератор модели" (нажав на ссылку на главной странице Gii). И заполните форму следующим образом: * Имя таблицы: `country` * Класс модели : `Country`  -Затем нажмите на кнопку "Предварительный просмотр". Вы увидите `models/Country.php` перечислен в результатах файл класса, который будет создан. Вы можете нажать на имя файла класса, для просмотра его содержимого. +Затем нажмите на кнопку "Предварительный просмотр". Вы увидите, что `models/Country.php` перечислен в результатах создаваемых файлов классов. Вы можете нажать на имя файла класса для просмотра его содержимого. -При использовании Gii, если вы уже создали такой же файл и хотите перезаписать его, нажмите кнопку `различия` рядом с именем файла, чтобы увидеть различия между генерируемого кода и существующей версии. +Если вы уже создали такой же файл и хотите перезаписать его, нажмите кнопку `diff` рядом с именем файла, чтобы увидеть различия между генерируемым кодом и существующей версией.  -Если необходимо перезаписать существующего файла, установите флажок рядом с "переписать", а затем нажмите кнопку "Создать". При создании нового файла, вы можете просто нажать "Создать". +Для перезаписи существующего файла установите флажок рядом с "overwrite" и нажмите кнопку "Generate". Для создания нового файла вы можете просто нажать "Generate". -Далее, вы увидите страницу подтверждения, указывающую что код был успешно создана. Если ваш файл уже существует, вы также увидите сообщение о том, что он был переписан с вновь сгенерированным кодом. +После этого вы увидите страницу подтверждения, указывающую на то, что код был успешно сгенерирован. Если файл существовал до этого, вы также увидите сообщение о том, что он был перезаписан заново сгенерированным кодом. Создание CRUD кода <a name="generating-crud"></a> -------------------- -CRUD расшифровывается как Создать, Читать, Обновить, и Удалить, представляющих четыре общие задачи, принятые с данными на большинстве веб-сайтов. Чтобы создать функциональность CRUD используйте Gii, выберите "CRUD Генератор" (нажав на ссылку на главной странице GII). Для «country», например, заполнить полученную форму следующим образом: +CRUD расшифровывается как Create, Read, Update и Delete, предоставляющий четыре основные функции, выполняемые над данными на большинстве веб-сайтов. Чтобы создать функциональность CRUD используя Gii, выберите "CRUD Генератор" (нажав на ссылку на главной странице Gii). Для нашей таблицы «country» заполните полученную форму следующим образом: -* Класс модели : `app\models\Country` -* Класс модели поиска: `app\models\CountrySearch` -* Класс контроллера: `app\controllers\CountryController` +* Model Class: `app\models\Country` +* Search Model Class: `app\models\CountrySearch` +* Controller Class: `app\controllers\CountryController`  -Затем, нажмите на кнопку "Предварительный просмотр". Вы увидите список файлов, которые будут созданы, как показано ниже. +Затем нажмите на кнопку "Preview". Вы увидите список файлов, которые будут созданы, как показано ниже. -[[ЗДЕСЬ НУЖНА КАРТИНКА]] + -Если вы ранее создали `controllers/CountryController.php` и `views/country/index.php` файлы (в разделе базы данных направляющей), установите флажок "переписать", чтобы заменить их. (Предыдущие версии не имеют полной поддержку CRUD.) +Если вы уже создали файлы `controllers/CountryController.php` и `views/country/index.php` (в разделе о базах данных), установите флажок "overwrite", чтобы заменить их. (Предыдущие версии не поддерживают CRUD полностью) -Пытается его <a name="trying-it-out"></a> +Испытываем в действии <a name="trying-it-out"></a> ------------- -Чтобы увидеть как она работает, используйте ваш браузер для доступа к следующему URL: +Чтобы увидеть как всё это работает, перейдите по следующему URL, используя ваш браузер: ``` http://hostname/index.php?r=country/index ``` -Вы увидите таблицу данных, показывающую страны из таблицы базы данных. Вы можете сортировать, или фильтр необходимо ввести условия фильтрации в заголовки столбцов. +Вы увидите таблицу, показывающую страны из таблицы БД. Вы можете сортировать, а также фильтровать данные, указывая условия фильтрации в заголовках столбцов. -Для каждой страны отображающейся в таблице, вы можете просмотреть подробную информацию, обновить ее или удалить. -Вы также можете нажать на кнопку "Создать страну" в верхней части таблицы и будет предоставлена форма для создания новой страны. +Для каждой отображающейся в таблице страны вы можете просмотреть подробную информацию, обновить или удалить её. +Вы также можете нажать на кнопку "Создать страну" в верхней части таблицы для получения формы создания новой страны.   -Ниже приведен список файлов созданных с помощью Gii, в случае если вы хотите исследовать эту реализацию функций, или их настройки: +Ниже приведен список файлов, созданных с помощью Gii, в том случае, если вы захотите исследовать реализацию этих функций, или изменить их: * Контроллер: `controllers/CountryController.php` -* Модели: `models/Country.php` and `models/CountrySearch.php` +* Модели: `models/Country.php` и `models/CountrySearch.php` * Вид: `views/country/*.php` -> Информация: Gii разработан как высоко настраиваемый и расширяемый инструмент генерации кода. Используя его с умом может значительно ускорить скорость разработки приложений. Для более подробной информации, пожалуйста обратитесь к разделу [Gii](tool-gii.md). +> Информация: Gii разработан как тонконастраиваемый и расширяемый инструмент генерации кода. Используя его с умом, вы можете значительно ускорить скорость разработки приложений. Для более подробной информации, пожалуйста, обратитесь к разделу [Gii](tool-gii.md). Заключение <a name="summary"></a> ------- -В этом разделе, Вы узнали как использовать Gii чтобы генерировать код который реализует полный функциональность CRUD для содержимого которое хранится в таблице базы данных. +В этом разделе вы узнали, как использовать Gii для генерации кода, реализующего полную функциональность CRUD для данных, хранящихся в таблице базы данных.