Генерація коду за допомогою Gii

Цей розділ описує, як використовувати Gii для автоматичної генерації коду, процедура якої має певні спільні риси з веб-сайтом. Використання Gii для автоматичного створення коду є простою процедурою введення правильної інформації згідно інструкцій, які містяться на Gii.

В даному керівництві ви дізнаєтесь:

  • Увімкнути Gii у вашому додатку
  • Використання Gii для генерації класів Active Record
  • Використання Gii для генерації коду по операціям CRUD бази даних
  • Налаштування коду, що був згенерований Gii

Підготовка Gii

Gii надається як модуль. Ви можете підключити модуль Gii, налаштувавши відповідну властивість [[yii\base\Application::modules|modules]] в налаштуваннях додатка. В залежності від налаштувань вашого додатка, ви можете знайти наступний код в конфігураційному файлі config/web.php:

$config = [ ... ];

if (YII_ENV_DEV) {
    $config['bootstrap'][] = 'gii';
    $config['modules']['gii'] = 'yii\gii\Module';
}

Наведена вище конфігурація підключає модуль gii у тому випадку, коли ваш додаток знаходиться в середовищі розробки і наслідує клас [[yii\gii\Module]].

Якщо ви перевірите вхідний скрипт web/index.php вашого додатку, то знайдете наступний рядок YII_ENV_DEV, який переводить додаток в середовище розробки.

defined('YII_ENV') or define('YII_ENV', 'dev');

Завдяки даному рядку, ваш додаток знаходиться в режимі розробки, і буде підключати Gii, із вищевказаною конфігурацією. Тепер ви можете отримати доступ до Gii за наступною адресою:

http://hostname/index.php?r=gii

Примітка: Якщо ви звертаєтеся до Gii від машини, крім локальної, доступ буде заборонений за замовчуванням із міркувань безпеки. Ви можете налаштувати Gii, додавши дозволені IP адреси, як показано нижче,

'gii' => [
    'class' => 'yii\gii\Module',
    'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'] // налаштувати для ваших потреб
],

Gii

Генерація класу Active Record

Використовуючи Gii для генерації класу Active Record, виберіть "Model Generator" (натиснувши на посилання на сторінці Gii). Далі заповніть форму наступними даними:

  • Ім’я таблиці: country
  • Клас моделі: Country

Генератор моделі

Далі, натисніть на кнопку "Перегляду" ("Preview"). Ви побачите файл models/Country.php, який буде створено в результаті даних дій. Ви можете натиснути на ім’я файлу класу для перегляду його вмісту.

Якщо при використанні Gii, раніше вже був створений файл моделі, то він буде перезаписаний. Для того, щоб переглянути відмінності в коді натисніть на кнопку diff поруч з ім’ям файлу.

Прев’ю генератора моделі

При перезаписі існуючого файлу, встановіть прапорець поруч із чекбоксом "перезаписати" ("overwrite"), а потім натисніть кнопку "Створити" ("Generate"). При створенні нового файлу, ви можете просто натиснути на кнопку "Створити" ("Generate").

Далі, ви побачите сторінку підтвердження із відображенням коду, який був сгенерований. Якщо ви перезаписували вже існуючий файл, то побачите повідомлення про те, що він був переписаний і замінений на щойно згенерований код.

Генерація коду CRUD

CRUD розшифровується як Створити, Прочитати, Оновити, і Видалити, це операції що вирішують чотири спільні завдання з маніпулюванням даними на більшості веб-сайтів. Щоб створити CRUD інтерфейс використовуючи Gii, оберіть "CRUD Generator" (натиснувши відповідну кнопку на сторінці Gii). Наприклад, для таблиці "country", заповніть наступні поля форми:

  • Клас моделі: app\models\Country
  • Клас моделі пошуку: app\models\CountrySearch
  • Клас контролера: app\controllers\CountryController

CRUD генератор

Далі, натисніть на кнопку "Перегляду" ("Preview"). Ви побачите файл models/Country.php який буде створений в результаті даних дій. Ви можете натиснути на ім’я файлу класу для перегляду його вмісту.

Прев’ю CRUD генератор

Якщо ви попередньо створили контролер controllers/CountryController.php і файл представлення views/country/index.php (в розділі "Робота з базами даних" даного посібника), оберіть чекбокс "перезаписати" і замініть їх. (Попередні версії файлів на мають повного CRUD функціоналу.)

Спробуємо

Щоб побачити все, що було створено під час роботи, відкрийте в браузері наступний URL:

http://hostname/index.php?r=country/index

Ви побачите таблицю даних, що показує країни з таблиці бази даних. Ви зможете відсортувати сітку, або відфільтрувати пошук, вказавши умови фільтрації в заголовках стовпців.

Для кожної країни, що відображається в таблиці, ви можете використати функції перегляду деталей, оновлення даних, або взагалі видалити її. Ви також можете натиснути на кнопку "Створити країну" зверху сітки відображення, яка переадресує вас на форму створення нової країни.

Сітка даних країн

Оновлення даних країни

Нижче наведено перелік файлів, згенерованих Gii, у тому разі, якщо ви захочете дослідити, як реалізовані ці можливості, або доналаштувати їх під свої потреби:

  • Контролер: controllers/CountryController.php
  • Моделі: models/Country.php і models/CountrySearch.php
  • Представлення: views/country/*.php

Інформація: Gii це гнучкий і розширюваний інструмент для генерації коду. При правильному використувані, від дозволить вам значно прискорити розробку ваших додатків. Для більш докладної інформації, будьласка, зверніться до розділу Gii.

Підсумок

В цьому розділі ви дізналися як, використовуючи Gii, генерувати код, який реалізує повну функціональність CRUD для маніпулювання даними, що зберігаються в таблицях баз даних.