Buat aplikasi CRUD Yii2 secara otomatis dengan Gii

Pada tutorial ini, saya akan membahas bagaimana cara membuat aplikasi CRUD (Create Read Update Delete) database secara otomatis dengan menggunakan tools Yii2 yaitu Gii. Dimana kita bisa membuat aplikasi CRUD melalui tampilan GUI / Web-based, dan Gii akan meng auto-generate Model, Controller, Active Record dan Action untuk operasi CRUD beserta view yang sudah jadi. Yang nantinya kita hanya perlu mengubah-ubah sesuai dengan keinginan kita tanpa harus koding dari awal.

Dalam tutorial ini, anda akan mempelajari tentang:

• Bagaimana mengaktifkan Gii di aplikasi Yii2 anda.
• Bagaimana menggunakan Gii untuk meng-generate class Active Record.
• Bagaimana menggunakan Gii untuk meng-generat kode untuk operasi CRUD pada Database.
• Bagaimana meng kustomisasi kode yang digenerasi oleh Gii.

Gii di Yii 2

Gii disediakan Yii sebagai module. Anda dapat mengaktifkan gii dengan mengkonfigurasinya di property module pada aplikasi. Tergantung bagaimana anda membuat aplikasi anda. Mungkin anda akan menemukan kode berikut sudah disediakan di file konfigurasi config/web.php:

$config = [ ... ];

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

Konfigurasi diatas menyatakan bahwa saat mode development, aplikasi meng-include module bernama gii, yang merupakan class yii\gii\Module.

Jika anda mengecek entry script web/index.php dari aplikasi anda, anda akan menemukan baris berikut:

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

Yang artinya aplikasi anda sedang dalam mode development. Karena konstanta YII_ENV_DEV bernilai true.

Sekarang buka browser anda dan akses alamat:

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

Perlu dicatat bahwa Gii hanya bisa diakses melalui localhost. Jika anda ingi mengaksesnya melalui IP lain, silahkan merujuk pada bagian Mengakses Gii dari alamat IP Lain dibawah.

Membuat class Active Record  dengan Gii

Untuk menggunakan Gii untuk meng-generasi class Active Record, pilih menu "Model Generator". Lalu isi form dengan nilai berikut:

1. Table Name : country
2. Model Class : Country

Selanjutnya, kl ik tombol "preview". anda akan melihat models/Country.php terdaftar di list file class yang akan dibuat/digenerasi. Anda bisa klik nama class untuk menampilkan isinya (kode yang akan di generate).

Saat menggunakan Gii, jika anda sudah membuat file dengan nama yang sama dan akan me-replace nya, anda bisa klik tombol diff disamping nama file untuk melihat perbandingan kode antara file yang sudah ada dengan yang akan dibuat.
Saat overwrite file yang sudah ada, beri centang pada checkbox disamping tulisan overwrite lalu klik tombol Generate.

Selanjutnya akan muncul halaman konfirmasi yang menandakan bahwa kode sukses dibuat. Jika ada file yang di overwirte, anda juga akan melihat pesan yang menandakan file di overwrite.

Membuat CRUD dengan Gii

CRUD adalah singkatan dari Create, Read, Update, dan Delete. Merupakan 4 tugas umum untuk operasi data pada website. Untuk membuat CRUD menggunakan Gii, pilih menu "CRUD Generator". Untuk contoh "country" yang sudah kita buat, isikan nilai berikut:
Model Class : app\models\Country
Search Model Class: app\models\CountrySearch
Controller Class: app\controllers\CountryController
lalu klik tombol "Preview". Seperti pada Module Generator, anda akan melihat daftar file yang akan dibuat. Untuk CRUD, file yang akan dibuat terdiri dari banyak file yang terdiri dari file controller, model, dan view. Dimana untuk view sendiri terdiri dari banyak file yang masing-masing mewakili halaman index, create, update dan lain lain.

Jangan lupa beri tanda centang disamping "overwrite" untuk meng-overwrite file yang sudah ada.

Uji Coba Hasil CRUD yang di auto-generate Gii

Untuk melihat hasilnya, silahkan buka URL:

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

Anda akan melihat tabel data country dari database. Dan tidak hanya itu, anda juga akan disuguhi dengan fitur filter pada header tabel, navigasi pagination, breadcrumb, dan tombol untuk membuat country baru.


Anda juga bisa mencoba untuk menambahkan data country dengan klik tombol "Create Country", dan anda akan dialihkan ke sebuah form yang terdapat beberapa kolom input yang sesuai untuk data country. Kolom input tersebut sudah dibuat secara otomatis oleh Gii berdasarkan field tabel pada database dan tipe datanya. Sungguh sangat praktis bukan?
Berikut adalah daftar file yang di auto-generate oleh Gii:

• Controller: controllers/CountryController.php
• Model: models/Country.php dan models/CountrySearch.php
• View: views/country/*.php

Anda bisa melihat source code dari file-file tersebut untuk memahami bagaimana cara kerja CRUD tadi, anda juga bisa mengedit file-file tersebut sesuai kebutuhan anda.

Catatan : Tool Gii ini bertujuan untuk memudahkan dan mempercepat proses development aplikasi anda. Hasil dari auto-generate dirancang untuk dapat di kustom semudah mungkin.

Tambahan : Mengakses Gii dari alamat IP lain

Gii hanya bisa diakses melalui localhost untuk alasan keamanan (jelas), apabila anda ingin dapat mengakses Gii dari alamat IP lain (tidak disarankan), silahkan tambahkan konfigurasi berikut pada file konfigurasi config/web.php :

'gii' => [
    'class' => 'yii\gii\Module',
    'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'] // adjust this to your needs
],

loading...