Membuat Aplikasi Pertama Yii Anda
Sebagai pengalaman pertama dengan Yii, di bagian ini kami akan menjelaskan bagaimana
membuat aplikasi Yii. Kita akan menggunakan yiic
(tool command line)
untuk membuat aplikasi Yii baru dan Gii
(sebuah code generator berbasis web)
untuk mengautomatisasi pembuatan code untuk tugas-tugas tertentu. Untuk kenyamanan,
kita akan berasumsi YiiRoot
sebagai direktori di mana Yii diinstalasi, dan WebRoot
adalah document root dari Web Server kita.
Jalankan yiic
pada baris perintah seperti berikut:
Catatan: Saat menjalankan
yiic
pada Mac OS, Linux atau Unix, Anda harus mengubah perijinan fileyiic
agar bisa dijalankan. Alternatif lain, Anda bisa menjalankan piranti seperti berikut,
Ini akan membuat kerangka aplikasi Yii di bawah direktori
WebRoot/testdrive
. Aplikasi memiliki struktur direktori yang
diperlukan oleh umumnya aplikasi Yii.
Tanpa harus menulis satu baris kode pun, kita dapat menguji aplikasi pertama Yii kita dengan mengakses URL berikut dalam Web browser:
Seperti yang kita lihat, aplikasi memiliki empat halaman: halaman beranda, halaman tentang (about) halaman kontak dan halaman masuk(login). Halaman kontak menampilkan sebuah form kontak yang dapat diisi pengguna dan mengirim pertanyaan mereka ke webmaster, sedangkan halaman masuk memungkinkan pengunjung diotentikasi sebelum mengakses isi khusus bagi yang sudah login.
Halaman beranda

Halaman kontak

Halaman dengan input error

Halaman kontak dengan pesan sukses

Halaman masuk

Diagram berikut memperlihatkan struktur direktori pada aplikasi kita Silahkan lihat Konvensi utuk keterangan lebih rinci mengenai struktur ini.
Sambungan ke Database
Umumnya aplikasi Web didukung oleh database. Aplikasi testdrive (pengujian) kita tidak
terkecuali. Untuk menggunakan database, pertama kita perlu memberitahu
aplikasi bagaimana untuk berhubungan dengannya. Ini dilakukan dengan mengubah file
konfigurasi aplikasi WebRoot/testdrive/protected/config/main.php
, seperti terlihat di bawah ini:
Kode di atas akan menginstruksi Yii bahwa aplikasi harus terkoneksi dengan database SQLite
WebRoot/testdrive/protected/data/testdrive.db
ketika diperlukan. Perhatikan bahwa database
SQLite sudah di dalam kerangka aplikasi yang baru saja kita generate. Database mengandung
sebuah tabel bernama tbl_user
:
Jika ingin mencoba database MySQL, Anda harus menyertakan file skema MySQL
WebRoot/testdrive/protected/data/schema.mysql.sql
untuk membuat database.
Catatan: Untuk menggunakan fitur database, kita harus mengaktifkan extension PDO dan extension PDO driver-spesifik. Untuk aplikasi testdrive, kita perlu mengaktifkan extension
php_pdo
danphp_pdo_sqlite
Mengimplementasikan Operasi CRUD
Sekarang tiba saat yang menarik. Kita akan mengimplementasi operasi
CRUD (create, read, update dan delete) untuk tabel tbl_user
yang baru saja kita buat.
Biasanya hal seperti ini sering kita lakukan dalam aplikasi umumnya. Alih-alih harus
merepotkan diri menulis code, kita akan menggunakan Gii
-- sebuah generator berbasis web.
Info: Gii sudah tersedia semenjak versi 1.1.2. Sebelumnya, kita menggunakan
yiic
(yang baru saja disinggung) untuk melakukan hal yang sama. Untuk lebih detail silahkan merujuk ke Mengimplementasi Operasi CRUD dengan yiic shell.
Konfigurasi Gii
Untuk menggunakan Gii, kita pertama harus mengubah file WebRoot/testdrive/protected/config/main.php
, yang juga dikenal sebagai file konfigurasi aplikasi:
Kemudian buka URL http://hostname/testdrive/index.php?r=gii
. Kita akan diminta password, yang baru saja dimasukkan di konfigurasi aplikasi di atas.
Menghasilkan User Model
Setelah login, klik ke link Model Generator
. Menu ini akan membawa kita ke halaman penghasil model,
Model Generator

Dalam field Table Name
, masukkan tbl_user
. Di dalam field Model Class
, masukkan User
. Kemudian klik tombol Preview
yang akan memunculkan file kode baru yang akan dihasilkan. Klik tombol Generate
. Sebuah nama file bernama User.php
akan dihasilkan di protected/models
. Kelas model User
ini akan memungkinkan kita untuk berkomunikasi dengan tabel tbl_user
dalam gaya berorientasi objek, yang nanti akan dibahas lebih lanjut.
Menghasilkan CRUD Code
Setelah membuat file kelas model, kita akan menghasilkan kode untuk mengimplementasi operasi CRUD tentang data user. Kita akan memilih Crud Generator
di Gii, yang ditampilkan sebagai berikut,
CRUD Generator

Dalam field Model Class
, masukkan User
. Di dalam field Controller ID
, masukkan user
(dalam huruf kecil). Sekarang tekan tombol Preview
diikuti tombol Generate
. Kita telah menyelesaikan proses penghasilan kode CRUD.
Mengakses halaman CRUD
Mari kita nikmati pekerjaan kita dengan melihatnya di URL berikut:
Ini akan menampilkan sebuah daftar entri pengguna dalam tabel User
.
Klik tombol Create User
. Kita akan dibawa ke halaman login
jika kita belum login sebelumnya. Setelah masuk, kita melihat form
input yang mengijinkan kita untuk menambah entri pengguna baru. Lengkapi form dan
klik tombol Create
. Lengkapi form dan klik tombol Create
. Jika terjadi kesalahan input,
sebuah tampilan error yang bagus akan muncul dan mencegah kita menyimpan inputan kita.
Kembali ke halaman daftar user, kita seharusnya melihat sebuah user baru sudah muncul di daftar.
Ulangi langkah di atas untuk menambah lebih banyak pengguna. Harap diingat bahwa halaman daftar pengguna akan dipaginasi secara otomatis jika terlalu banyak pengguna yang harus ditampilkan pada satu halaman.
Jika kita login sebagai administrator menggunakan admin/admin
, kita dapat melihat halaman
pengguna admin dengan URL berikut:
Ini akan memperlihatkan tabel entri user yang bagus. Kita dapat mengklik sel header tabel guna mengurut sesuai kolom terkait. Kita dapat mengklik tombol pada setiap baris untuk melihat, meng-update atau menghapus baris data bersangkutan. Kita dapat membuka halaman-halaman berbeda. Kita juga dapat memfilter dan mencari data yang diinginkan.
Semua fitur bagus ini disediakan tanpa harus menulis satu baris kode pun!
Halaman admin pengguna

Halaman membuat pengguna baru
