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:% YiiRoot/framework/yiic webapp WebRoot/testdrive
Catatan: Saat menjalankanyiic
pada Mac OS, Linux atau Unix, Anda harus mengubah perijinan fileyiic
agar bisa dijalankan. Alternatif lain, Anda bisa menjalankan piranti seperti berikut,
% cd WebRoot/testdrive % php YiiRoot/framework/yiic.php webapp WebRoot/testdrive
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:
http://hostname/testdrive/index.php
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.
testdrive/
index.php Web application entry script file
index-test.php entry script file for the functional tests
assets/ containing published resource files
css/ containing CSS files
images/ containing image files
themes/ containing application themes
protected/ containing protected application files
yiic yiic command line script for Unix/Linux
yiic.bat yiic command line script for Windows
yiic.php yiic command line PHP script
commands/ containing customized 'yiic' commands
shell/ containing customized 'yiic shell' commands
components/ containing reusable user components
Controller.php the base class for all controller classes
UserIdentity.php the 'UserIdentity' class used for authentication
config/ containing configuration files
console.php the console application configuration
main.php the Web application configuration
test.php the configuration for the functional tests
controllers/ containing controller class files
SiteController.php the default controller class
data/ containing the sample database
schema.mysql.sql the DB schema for the sample MySQL database
schema.sqlite.sql the DB schema for the sample SQLite database
testdrive.db the sample SQLite database file
extensions/ containing third-party extensions
messages/ containing translated messages
models/ containing model class files
LoginForm.php the form model for 'login' action
ContactForm.php the form model for 'contact' action
runtime/ containing temporarily generated files
tests/ containing test scripts
views/ containing controller view and layout files
layouts/ containing layout view files
main.php the base layout shared by all pages
column1.php the layout for pages using a single column
column2.php the layout for pages using two columns
site/ containing view files for the 'site' controller
pages/ containing "static" pages
about.php the view for the "about" page
contact.php the view for 'contact' action
error.php the view for 'error' action (displaying external errors)
index.php the view for 'index' action
login.php the view for 'login' action
1. 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:return array(
......
'components'=>array(
......
'db'=>array(
'connectionString'=>'sqlite:protected/data/source.db',
),
),
......
);
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
:CREATE TABLE tbl_user (
id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
username VARCHAR(128) NOT NULL,
password VARCHAR(128) NOT NULL,
email VARCHAR(128) NOT NULL
);
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 extensionphp_pdo
danphp_pdo_sqlite
2. 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 menggunakanyiic
(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:return array(
......
'import'=>array(
'application.models.*',
'application.components.*',
),
'modules'=>array(
'gii'=>array(
'class'=>'system.gii.GiiModule',
'password'=>'pilih password di sini',
),
),
);
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:
http://hostname/testdrive/index.php?r=user
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:http://hostname/testdrive/index.php?r=user/admin
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
0 komentar:
Posting Komentar