Merge pull request #4653 from RichWeber/master

docs/guide-uk/start-gii.md

+Генерація коду за допомогою Gii
+========================
+
+Цей розділ описує, як використовувати [Gii](tool-gii.md) для автоматичної генерації коду, процедура якої має певні спільні риси з веб-сайтом. Використання Gii для автоматичного створення коду є простою процедурою введення правильної інформації згідно інструкцій, які містяться на 
+Gii.
+
+В даному керівництві ви дізнаєтесь:
+
+* Включити Gii у вашому додатку
+* Використання Gii для генерації Active Record класів
+* Використання Gii для генерації коду по операціям CRUD бази даних
+* Налаштування коду, що був згенерований Gii
+
+
+Підготовка Gii <a name="starting-gii"></a>
+------------
+
+[Gii](tool-gii.md) надається як [модуль](structure-modules.md). Ви можете підключити Gii налаштувавши його модуль [[yii\base\Application::modules|modules]] в налаштуваннях додатка. В залежності від налаштувань вашого додатка, ви можете знайти наступний код в конфігураційному файлі `config/web.php`:
+
+```php
+$config = [ ... ];
+
+if (YII_ENV_DEV) {
+    $config['bootstrap'][] = 'gii';
+    $config['modules']['gii'] = 'yii\gii\Module';
+}
+```
+
+Наведена вище конфігурація підключає модуль `gii` в тому випадку, коли ваш додаток знаходиться в [середовищі розробки](concept-configurations.md#environment-constants) і наслідує клас [[yii\gii\Module]].
+
+Якщо ви перевірите [вхідний скрипт](structure-entry-scripts.md) `web/index.php` вашого додатку, то знайдете наступний рядок `YII_ENV_DEV`, який переводить додаток в середовище розробки.
+
+```php
+defined('YII_ENV') or define('YII_ENV', 'dev');
+```
+
+Завдяки даному рядку, ваш додаток знаходиться в режимі розробки, і буде підключати Gii, із вищевказаною конфігурацією. Тепер ви можете отримати доступ до Gii за наступною адресою:
+
+```
+http://hostname/index.php?r=gii
+```
+
+![Gii](../guide/images/start-gii.png)
+
+
+Генерація класу Active Record <a name="generating-ar"></a>
+---------------------------------
+
+Використовуючи Gii для генерації класу Active Record, виберіть "Model Generator" (натиснувши на посилання на сторінці Gii). Далі заповніть форму наступними даними:
+
+* Ім’я таблиці: `country`
+* Клас моделі: `Country`
+
+![Герератор моделі](../guide/images/start-gii-model.png)
+
+Далі, натисніть на кнопку "Перегляду". Ви побачите файл `models/Country.php` який буде створений в результаті даних дій. Ви можете натиснути на ім'я файлу класу для перегляду його вмісту.
+
+Якщо при використанні Gii, раніше вже був створений файл моделі, то він буде перезаписаний. Для того, щоб переглянути відмінності в коді натисніть на кнопку `diff` поруч з ім'ям файлу.
+
+![Прев'ю генератора моделі](../guide/images/start-gii-model-preview.png)
+
+При перезаписі існуючого файлу, встановіть прапорець поруч із чекбоксом "перезаписати", а потім натисніть кнопку "Створити". При створенні нового файлу, ви можете просто натиснути на кнопку "Створити".
+
+Далі, ви побачите сторінку підтвердження із відображенням коду, який був сгенерований. Якщо ви перезаписували вже існуючий файл, то побачите повідомлення про те, що він був переписаний і замінений на щойно згенерований код.
+
+
+Генерація коду CRUD <a name="generating-crud"></a>
+--------------------
+
+CRUD розшифровується як Створити, Прочитати, Оновити, і Видалити, це операції що вирішують чотири спільні завдання з маніпулюванням даними на більшості веб-сайтів. Щоб створити CRUD інтерфейс використовуючи Gii, виберіть "CRUD Generator" (натиснувши відповідну кнопку на сторінці Gii). Наприклад, для таблиці "country", заповніть наступні поля форми:
+
+* Клас моделі: `app\models\Country`
+* Клас моделі пошуку: `app\models\CountrySearch`
+* Клас контролера: `app\controllers\CountryController`
+
+![CRUD генератор](../guide/images/start-gii-crud.png)
+
+Далі, натисніть на кнопку "Перегляду". Ви побачите файл `models/Country.php` який буде створений в результаті даних дій. Ви можете натиснути на ім'я файлу класу для перегляду його вмісту.
+
+[[NEED THE IMAGE HERE]]
+
+Якщо ви попередньо створили контролер `controllers/CountryController.php` і файл предствлення `views/country/index.php` (в розділі "Робота з базами даних" даного посібника), виберіть чекбокс "перезаписати" і замініть їх. (Попередні версії файлів на мають повного CRUD функціоналу.)
+
+
+Спробуєм <a name="trying-it-out"></a>
+-------------
+
+Щоб побачити все, що було створено під час роботи, відкрийте в браузері наступний URL:
+
+```
+http://hostname/index.php?r=country/index
+```
+
+Ви побачите таблицю даних, що показує країни з таблиці бази даних. Ви зможете відсортувати сітку, або відфільтрувати пошук, вказавши умови фільтрації в заголовках стовпців.
+
+Для кожної країни, що відображаються в таблиці, ви можете використати функції перегляду деталей, оновлення даних, або взагалі видалити її. Ви також можете натиснути на кнопку "Створити країну" зверху сітки відображення, яка переадресує вас на форму створення нової країни.
+
+![Сітка даних країн](../guide/images/start-gii-country-grid.png)
+
+![Оновлення даних країни](../guide/images/start-gii-country-update.png)
+
+Нижче представлений список файлів, згенерованих Gii, в тому разі, якщо ви захочете дослідити, як реалізовані ці можливості, або доналаштувати їх під свої потреби:
+
+* Контролер: `controllers/CountryController.php`
+* Моделі: `models/Country.php` і `models/CountrySearch.php`
+* Представлення: `views/country/*.php`
+
+> Інформація: Gii це гнучкий і розширюваний інструмент для генерації коду. При правильному використувані, від дозволить вам значно прискорити розробку ваших додатків. Для більш докладної інформації, будьласка, зверніться до розділу [Gii](tool-gii.md).
+
+
+Резюме <a name="summary"></a>
+-------
+
+В цьому розділі ви дізналися, як використовуючи Gii генерувати код, який реалізує повну функціональність CRUD для маніпулювання даними що зберігаються в таблицях баз даних.