mirror of
https://github.com/yiisoft/yii2.git
synced 2025-11-30 06:29:02 +08:00
115 lines
8.8 KiB
Markdown
115 lines
8.8 KiB
Markdown
Генерація коду за допомогою 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
|
||
```
|
||
|
||
|
||
|
||
|
||
Генерація класу Active Record <a name="generating-ar"></a>
|
||
---------------------------------
|
||
|
||
Використовуючи Gii для генерації класу Active Record, виберіть "Model Generator" (натиснувши на посилання на сторінці Gii). Далі заповніть форму наступними даними:
|
||
|
||
* Ім’я таблиці: `country`
|
||
* Клас моделі: `Country`
|
||
|
||
|
||
|
||
Далі, натисніть на кнопку "Перегляду". Ви побачите файл `models/Country.php` який буде створений в результаті даних дій. Ви можете натиснути на ім'я файлу класу для перегляду його вмісту.
|
||
|
||
Якщо при використанні Gii, раніше вже був створений файл моделі, то він буде перезаписаний. Для того, щоб переглянути відмінності в коді натисніть на кнопку `diff` поруч з ім'ям файлу.
|
||
|
||
|
||
|
||
При перезаписі існуючого файлу, встановіть прапорець поруч із чекбоксом "перезаписати", а потім натисніть кнопку "Створити". При створенні нового файлу, ви можете просто натиснути на кнопку "Створити".
|
||
|
||
Далі, ви побачите сторінку підтвердження із відображенням коду, який був сгенерований. Якщо ви перезаписували вже існуючий файл, то побачите повідомлення про те, що він був переписаний і замінений на щойно згенерований код.
|
||
|
||
|
||
Генерація коду CRUD <a name="generating-crud"></a>
|
||
--------------------
|
||
|
||
CRUD розшифровується як Створити, Прочитати, Оновити, і Видалити, це операції що вирішують чотири спільні завдання з маніпулюванням даними на більшості веб-сайтів. Щоб створити CRUD інтерфейс використовуючи Gii, виберіть "CRUD Generator" (натиснувши відповідну кнопку на сторінці Gii). Наприклад, для таблиці "country", заповніть наступні поля форми:
|
||
|
||
* Клас моделі: `app\models\Country`
|
||
* Клас моделі пошуку: `app\models\CountrySearch`
|
||
* Клас контролера: `app\controllers\CountryController`
|
||
|
||
|
||
|
||
Далі, натисніть на кнопку "Перегляду". Ви побачите файл `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
|
||
```
|
||
|
||
Ви побачите таблицю даних, що показує країни з таблиці бази даних. Ви зможете відсортувати сітку, або відфільтрувати пошук, вказавши умови фільтрації в заголовках стовпців.
|
||
|
||
Для кожної країни, що відображаються в таблиці, ви можете використати функції перегляду деталей, оновлення даних, або взагалі видалити її. Ви також можете натиснути на кнопку "Створити країну" зверху сітки відображення, яка переадресує вас на форму створення нової країни.
|
||
|
||
|
||
|
||
|
||
|
||
Нижче представлений список файлів, згенерованих Gii, в тому разі, якщо ви захочете дослідити, як реалізовані ці можливості, або доналаштувати їх під свої потреби:
|
||
|
||
* Контролер: `controllers/CountryController.php`
|
||
* Моделі: `models/Country.php` і `models/CountrySearch.php`
|
||
* Представлення: `views/country/*.php`
|
||
|
||
> Інформація: Gii це гнучкий і розширюваний інструмент для генерації коду. При правильному використувані, від дозволить вам значно прискорити розробку ваших додатків. Для більш докладної інформації, будьласка, зверніться до розділу [Gii](tool-gii.md).
|
||
|
||
|
||
Резюме <a name="summary"></a>
|
||
-------
|
||
|
||
В цьому розділі ви дізналися, як використовуючи Gii генерувати код, який реалізує повну функціональність CRUD для маніпулювання даними що зберігаються в таблицях баз даних.
|