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 file yiic 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 beranda

Halaman kontak

Halaman kontak

Halaman dengan input error

Halaman dengan input error

Halaman kontak dengan pesan sukses

Halaman kontak dengan pesan sukses

Halaman masuk

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 dan php_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

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

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 admin pengguna

Halaman membuat pengguna baru

Halaman membuat pengguna baru
$Id: quickstart.first-app.txt 3219 2011-05-13 03:03:35Z qiang.xue $