Konvensi

Yii mempunyai konvensi terhadap konfigurasi. Ikuti konvensi dan seseorang bisa membuat aplikasi Yii yang memuaskan tanpa harus menulis dan mengatur konfigurasi yang rumit. Tentunya, Yii masih dapat dikustomisasi dalam hampir setiap aspek dengan konfigurasi bila diperlukan.

Di bawah ini dijelaskan konvensi yang direkomendasikan untuk pemrograman Yii. Demi kenyamanan, kami asumsikan bahwa WebRoot adalah direktori di mana aplikasi Yii diinstalasi.

URL

Secara standar, Yii mengenali URL dengan format berikut:

http://hostname/index.php?r=ControllerID/ActionID

Variabel GET r merujuk pada rute yang bisa dipecah oleh Yii menjadi kontroler dan aksi. Jika ActionID tidak ada, kontroler akan mengambil aksi standar (didefinisikan via CController::defaultAction); dan jika ControllerID juga tidak ada (atau variabel r tidak ada), aplikasi akan menggunakan kontoler standar (didefinsikan via CWebApplication::defaultController).

Dengan bantuan CUrlManager, memungkinkan URL dibuat dan dikenal lebih ramah-SEO-friendly, seperti http://hostname/ControllerID/ActionID.html. Fitur ini dicakup secara rinci dalam URL Management.

Kode

Yii merekomendasikan penamaan variabel, fungsi dan tipe kelas dalam jenis huruf kamel yang membesarkan setiap kata pada nama dan menggabungkannya tanpa spasi. Nama variabel dan spasi namanya semuanya harus dalam huruf kecil, tujuannya untuk membedakannya dari nama kelas (contoh $basePath, runController(), LinkPager). Untuk variabel anggota kelas private, direkomendasikan untuk mengawali namanya dengan karakter garis bawah (contoh $_actionList).

Karena namespace tidak didukung oleh PHP sebelum versi 5.3.0, direkomendasikan bahwa kelas dinamai dalam cara yang unik guna menghindari konflik nama dengan kelas pihak-ketiga. Untuk alasan ini, semua kelas Yii framework diawali dengan huruf "C".

Aturan khusus untuk nama kelas kontroler, ia harus ditambah dengan kata Controller. Kemudian ID kontroler didefinisikan sebagai nama kelas dengan huruf pertamanya dalam huruf kecil dan kata Controller dipotong. Sebagai contoh, kelas PageController akan memiliki ID page. Aturan ini membuat aplikasi lebih aman. Ini juga menjadikan URL yang terkait dengan kontroler sedikit lebih bersih (contoh /index.php?r=page/index daripada /index.php?r=PageController/index).

Konfigurasi

Konfigurasi adalah sebuah array pasangan kunci-nilai. Setiap kunci mewakili nama properti obyek yang dikonfigurasi, dan setiap nilai merupakan nilai awal properti tersebut. Sebagai contoh, array('name'=>'My application', 'basePath'=>'./protected') mengawali properti name dan basePath ke nilai array terkait.

Setiap properti obyek yang bisa ditulis dapat dikonfigurasi. Jika tidak dikonfigurasi, properti akan mengambil nilai standar awal. Ketika mengkonfigurasi properti, tidak ada salahnya untuk membaca dokumentasi terkait agar nilai awal dapat diberikan dengan benar.

File

Konvensi penamaan dan penggunaan file tergantung pada tipenya.

File Kelas harus dinamai setelah kelas publik. Sebagai contoh, kelas CController pada file CController.php. Kelas publik adalah kelas yang dipakai oleh kelas lain. Setiap file kelas harus berisi paling banyak satu kelas. Kelas Private (kelas yang hanya dipakai oleh satu kelas publik) bisa berada dalam file yang sama dengan kelas publik.

File tampilan harus dinamai setelah nama tampilan. Sebagai contoh, tampilan index ada dalam file index.php. File tampilan adalah file naskah PHP yang berisi kode HTML dan PHP terutama untuk keperluan penyajian.

File konfigurasi bisa dinamai secara arbitrari. File konfigurasi adalah naskah PHP yang bertujuan untuk mengembalikan sebuah array asosiasi yang mewakili konfigurasi.

Direktori

Yii menganggap set standar direktori yang dipakai untuk berbagai keperluan. Masing-masing bisa dikustomisasi jika diperlukan.

• WebRoot/protected: ini adalah basis direktori aplikasi menampung semua naskah PHP sensitif-keamanan dan file data. Yii memiliki alias standar bernama application yang dikaitkan dengan path ini. Direktori ini dan semua yang ada di bawahnya dilindungi dari pengaksesan pengguna Web. Ia bisa dikustomisasi via CWebApplication::basePath.

• WebRoot/protected/runtime: direktori ini menampung file temporal privat yang dibuat selama menjalankan aplikasi. Direktori ini harus bisa ditulis oleh proses server Web. Ia dapat dikustomisasi melalui CApplication::runtimePath.

• WebRoot/protected/extensions: direktori ini menampung semua ekstensi pihak ketiga. Ia dapat dikustomisasi melalui CApplication::extensionPath.

• WebRoot/protected/modules: direktori ini menampung semua modul aplikasi, masing-masing diwakili oleh subdirektori.

• WebRoot/protected/controllers: direktori ini menampung semua file kelas kontroler. Ia dapat dikustomisasi melalui CWebApplication::controllerPath.

• WebRoot/protected/views: direktori ini menampung semua file tampilan, termasuk tampilan kontroler, tampilan tata letak dan tampilan sistem. Ia dapat dikustomisasi melalui CWebApplication::viewPath.

• WebRoot/protected/views/ControllerID: direktori ini menampung file tampilan untuk satu kelas kontroler. Di sini, ControllerID kepenekan dari ID kontroler. Ia dapat dikustomisasi melalui CController::getViewPath.

• WebRoot/protected/views/layouts: direktori ini menampung semua file tampilan tata letak. Ia dapat dikustomisasi melalui CWebApplication::layoutPath.

• WebRoot/protected/views/system: direktori ini menampung semua file tampilan sistem. Tampilan sistem adalah template yang dipakai dalam menampilkan eksepsi dan kesalahan. Ia dapat dikustomisasi melalui CWebApplication::systemViewPath.

• WebRoot/assets: direktori ini menampung file aset yang diterbitkan. File asset adalah file privat yang dapat diterbitkan agar bisa diakses oleh pengguna Web. Direktori ini harus bisa ditulis oleh proses server Web. Ia dapat dikustomisasi melalui CAssetManager::basePath.

• WebRoot/themes: direktori ini menampung berbagai tema yang dapat diterapkan pada aplikasi. Setiap subdirektori mewakili satu tema yang namanya adalah nama subdirektori. Ia dapat dikustomisasi melalui CThemeManager::basePath.

Modul

Catatan: Dukungan modul sudah tersedia sejak versi 1.0.3.

Modul adalah unit piranti lunak berdiri sendiri yang terdiri dari model, tampilan, kontroler dan komponen pendukung lainnya. Dalam banyak aspek, sebuah modul mirip dengan aplikasi. Perbedaan utamanya adalah bahwa modul tidak bisa disebarkan sendirian dan ia harus berada di dalam sebuah aplikasi. Para pengguna dapat mengakses kontroler dalam sebuah modul layaknya yang dilakukan dengan kontroler aplikasi biasa.

Modul berguna dalam beberapa skenario. Untuk aplikasi berskala-besar, kita dapat membaginya ke dalam beberapa modul, masing-masing dikembangkan dan dipelihara secara terpisah. Beberapa fitur yang umum digunakan, seperti misalnya manajemen pengguna, manajemen komentar, dapat dikembangkan dalam batasan modul agar dapat dipakai kembali dengan mudah dalam proyek mendatang.

Membuat Modul

Modul diatur sebagai direktori di mana namanya bertindak sebagai ID unik. Struktur direktori modul mirip dengan basis direktori aplikasi. Contoh berikut memperlihatkan struktur umum direktori pada modul bernama forum:

forum/
  ForumModule.php            file kelas modul
  components/                berisi komponen yang bisa dipakai ulang
     views/                  berisi file tampilan untuk widgets
  controllers/               berisi file kelas kontroler
     DefaultController.php   file kelas kontroler standar
  extensions/                berisi ekstensi pihak-ketiga
  models/                    berisi file kelas model
  views/                     berisi file tampilan kontroler dan tatat letak
     layouts/                berisi file tampilan tata letak
     default/                berisi file tampilan untuk DefaultController
        index.php            file tampilan indeks

Modul harus memiliki kelas modul yang diperluas dari CWebModule. Nama kelas ditentukan menggunakan ucfirst($id).'Module', di mana $id merujuk pada ID modul (atau nama direktori modul). Kelas modul bertindak sebagai pusat tempat penyimpanan informasi berbagi diantara kode modul. Sebagai contoh, kita dapat menggunakan CWebModule::params untuk menyimpan parameter modul, dan menggunakan CWebModule::components untuk berbagi komponen aplikasi pada tingkat modul.

Tip: Kita bisa menggunakan piranti yiic untuk membuat kerangka dasar modul baru. Sebagai contoh, untuk membuat modul forum di atas, kita dapat menjalankan perintah berikut dalam jendela baris perintah:

% cd WebRoot/testdrive
% protected/yiic shell
Yii Interactive Tool v1.0
Silahkan ketik 'help' untuk bantuan. Ketik 'exit' untuk keluar.
>> module forum

Menggunakan Modul

Untuk menggunakan modul, pertama tempatkan direktori modul di bawah basis direktori aplikasi modules. Kemudian deklarasikan ID modul dalam properti modul aplikasi. Sebagai contoh, agar bisa menggunakan modul forum di atas, kita dapat menggunakan konfigurasi aplikasi berikut:

return array(
   ......
   'modules'=>array('forum',...),
   ......
);

Modul juga bisa dikonfigurasi dengan nilai properti awal. Pemakaian ini mirip dengan mengkonfigurasi komponen aplikasi. Sebagai contoh, modul forum dapat memiliki properti bernama postPerPage dakan kelas modulnya yang bisa dikonfigurasi dalam konfigurasi aplikasi sebagai berikut:

return array(
   ......
   'modules'=>array(
       'forum'=>array(
           'postPerPage'=>20,
       ),
   ),
   ......
);

Turunan modul dapat diakses melalui properti modul pada kontroler yang aktif saat ini. Melalui turunan modul, selanjutnya kita dapat mengakses informasi yang dibagi pada tingkat modul. Sebagai contoh, agar bisa mengakses informasi postPerPage di atas, kita dapat menggunakan ekspresi berikut:

$postPerPage=Yii::app()->controller->module->postPerPage;
// atau yang berikut jika $this merujuk pada turunan kontroler
// $postPerPage=$this->module->postPerPage;

Aksi kontroler dalam sebuah modul dapat diakses menggunakan rute moduleID/controllerID/actionID. Sebagai contoh, menganggap modul forum di atas memiliki kontroler bernama PostController, kita dapat menggunakan rute forum/post/create untuk merujuk pada aksi create dalam kontroler ini. URL terkait untuk rute ini adalah http://www.example.com/index.php?r=forum/post/create.

Tip: Jika kontroler ada dalam sub-direktori controllers, kita masih dapat menggunakan format rute di atas. Sebagai contoh, menganggap PostController di bawah forum/controllers/admin, kita dapat merujuk pada aksi create menggunakan forum/admin/post/create.

Modul Berulang

Modul dapat diulang. Yaitu, sebuah modul bisa berisi modul lainnya. Kita menyebut pemanggil sebagai leluhur modul sementara yang dipanggil disebut anak modul. Anak modul harus ditempatkan di bawah direktori modules pada modul leluhurnya. Untuk mengakses aksi kontroler dalam anak modul, kita harus menggunakan rute parentModuleID/childModuleID/controllerID/actionID.

Alias Path dan Namespace

Yii menggunakan alias secara ekstensif. Alias path dikaitkan dengan direktori atau path file. Ditetapkan dalam sintaks titik, mirip dengan format namespace yang diadopsi secara luas:

RootAlias.path.ke.target

di mana RootAlias adalah alias dari beberapa direktori yang sudah ada. Dengan memanggil YiiBase::setPathOfAlias(), kita dapat menetapkan alias path baru. Demi kenyamanan, Yii sudah mendefinisikan alias root sebagai berikut:

• system: merujuk pada direktori Yii framework;
• application: merujuk pada basis direktori aplikasi;
• webroot: merujuk pada direktori yang berisi file naskah entri. Alias ini sudah tersedia sejak versi 1.0.3.

Sebagai tambahan, jika aplikasi menggunakan modul, alias root juga didefinisikan untuk setiap ID modul dan merujuk pada basis path modul terkait. Fitur ini sudah tersedia sejak versi 1.0.3.

Dengan menggunakan YiiBase::getPathOfAlias(), alias dapat diterjemahkan ke path terkait. Sebagai contoh, system.web.CController akan diterjemahkan sebagai yii/framework/web/CController.

Menggunakan alias, sangat nyaman untuk mengimpor definisi sebuah kelas. Sebagai contoh, jika kita ingin menyertakan definisi kelas CController, kita dapat memanggil seperti berikut:

Yii::import('system.web.CController');

Metode import berbeda dari include dan require dalam hal ia lebih efisien. Definisi kelas yang sedang diimpor sebenarnya tidak disertakan sampai ia dirujuk untuk pertama kali. Mengimpor namespace yang sama berkali-kali juga lebih cepat daripada include_once dan require_once.

Tip: Ketika merujuk pada kelas yang didefinisikan oleh Yii framework, kita tidak perlu mengimpor atau menyertakannya. Semua kelas inti Yii sudah pra-impor.

Kita juga dapat menggunakan sintaks berikut untuk mengimpor seluruh direktori agar file kelas di bawah direktori tersebut secara otomatis disertakan saat diperlukan.

Yii::import('system.web.*');

Selain import, alias juga dipakai di banyak tempat lain untuk merujuk pada kelas. Sebagai contoh, alias dapat dioper ke Yii::createComponent() guna membuat turunan kelas terkait, meskipun file kelas tidak disertakan sebelumnya.

Jangan menyamakan antara alias path dengan namespace. Namespace merujuk pada pengelompokan logis beberapa nama kelas agar dapat dibedakan dari nama kelas lainnya jika namanya sama, sementara alias path dipakai untuk merujuk pada file kelas atau direktori. Alias path tidak konflik dengan namespace.

Tip: Karena PHP sebelum versi 5.3.0 tidak mendukung namespace secara langsung, Anda tidak dapat membuat turunan dari dua kelas yang memiliki nama yang sama dengan definisi yang berbeda. Untuk alasan ini, semua kelas Yii framework diawali dengan huruf 'C' (berarti 'class') agar bisa dibedakan dari kelas yang didefinisikan-pengguna. Direkomendasikan bahwa prefiks 'C' khusus dipakai hanya untuk pemakaian Yii framework saja, dan kelas yang didefinisikan-pengguna diawali dengan huruf lainnya.

Komponen

Aplikasi Yii dibangun setelah komponen berupa obyek ditulis menjadi spesifikasi. Sebuah komponen adalah turunan dari CComponent atau kelas sebelumnya. Pemakaian komponen meliputi pengaksesan propertinya dan memunculkan/menangani event-nya. Kelas basis CComponent menetapkan bagaimana untuk mendefinisikan properti dan event.

Properti Komponen

Properti komponen seperti variabel anggota public sebuah obyek. Kita dapat membaca nilainya atau menempatkan sebuah nilai ke dalamnya. Sebagai contoh,

$width=$component->textWidth;     // ambil properti textWidth
$component->enableCaching=true;   // setel properti enableCaching

Untuk mendefinisikan properti komponen, kita cuku mendeklarasian variabel anggota public dalam kelas komponen. Cara yang lebih fleksibel adalah dengan mendefinisikan metode getter (pengambil) dan setter (penyetel) seperti berikut:

public function getTextWidth()
{
   return $this->_textWidth;
}

public function setTextWidth($value)
{
   $this->_textWidth=$value;
}

Kode di atas mendefinisikan properti yang bisa ditulis dengan nama textWidth (nama sensitif jenis huruf). Ketika membaca properti, getTextWidth() dipanggil dan nilai yang dihasilkannya menjadi nilai properti; Hal yang mirip, saat menulis properti, setTextWidth() dipanggil. Jika metode penyetel tidak didefinisikan, properti akan menjadi hanya-baca dan menulisinya akan memunculkan sebuah eksepsi. Menggunakan metode pengambil dan penyetel untuk mendefinisikan sebuah properti memiliki keuntungan bahwa logika tambahan (seperti melakukan validasi, memunculkan event) dapat dijalankan saat membaca dan menulis properti.

Catatan: Ada perbedaan menyolok antara properti yang didefinisikan via metode pengambil/penyetel dan variabel anggota kelas. Nama pengambil/penyetel tidak sensitif jenis huruf sementara variabel anggota kelas sensitif jenis huruf.

Event Komponen

Event komponen adalah properti khusus yang mengambil metode (disebut pengendali event) sebagai nilainya. Melampirkan (menempatkan) metode ke sebuah event akan menyebabkan metode dipanggil secara otomatis di tempat di mana event dimunculkan. Oleh karena itu, perilaku komponen bisa diubah dengan cara yang tidak bisa dilihat selama pengembangan komponen.

Event komponen didefinisikan dengan mendefinisikan sebuah metode yang namanya dimulai dengan on. Seperti nama properti yang didefinisikan via metode pengambil/penyetel, nama event tidak sensitif jenis huruf. Kode berikut mendefinisikan sebuah event onClicked:

public function onClicked($event)
{
   $this->raiseEvent('onClicked', $event);
}

di mana $event adalah turunan CEvent atau anak kelasnya yang menyediakan parameter event.

Kita dapat melampirkan sebuah metode ke event ini seperti berikut:

$component->onClicked=$callback;

di mana $callback merujuk ke PHP callback yang benar. Ia bisa berupa fungsi global atau metode kelas. Jika metode kelas, callback harus dibentuk sebagai array: array($object,'methodName').

Tanda tangan pengenali event harus seperti berikut:

function methodName($event)
{
   ......
}

di mana $event merupakan parameter yang menjelaskan event (ia berasal dari panggilan raiseEvent()). Parameter $event adalah turunan dari CEvent atau kelas sebelumnya. Pada kondisi minimum, ia berisi informasi mengenai siapa yang memunculkan event.

Jika kita memanggil onClicked() sekarang, event onClicked akan dimunculkan (di dalam onClicked()), dan pengendali event terlampir akan dipanggil secara otomatis.

Sebuah event dapat dilampirkan ke multipel pengendali. Saat event dimunculkan, pengendali akan dipanggil dengan urutan di mana ia dilampirkan ke event. Jika sebuah pengendali memutuskan untuk menghindari pemanggilan pengendali berikutnya, bisa dilakukan dengan menyetel $event->handled menjadi true.

Perilaku Komponen

Mulai dari versi 1.0.2, sebuah komponen sudah ditambahkan guna mendukung mixin dan dapat dilampirkan dengan satu atau beberapa perilaku. Sebuah perilaku adalah obyek yang metodenya bisa 'inherited' (diturunkan) dengan komponen lampirannya dalam arti pengumpulan fungsionalitas daripada spesialisasi (misal, penurunan kelas normal). Komponen dapat dilampirkan ke beberapa perilaku dan selanjutnya melakukan 'multipel penurunan'.

Kelas perilaku harus mengimplementasikan antar muka IBehavior. Umumnya perilaku dapat diperluas dari kelas basis CBehavior. Jika perilaku perlu dilampirkan ke sebuah model, ia juga bisa diperluas dari CModelBehavior atau CActiveRecordBehavior yang mengimplementasikan fitur tambahan tertentu untuk model.

Untuk menggunakan perilaku, ia harus dilampirkan ke sebuah komponen lebih dulu dengan memanggil metode perilaku attach(). Kemudian kita memanggil metode perilaku melalui komponen:

// $name secara unik mengidentifikasi behavior dalam komponen
$behavior->attach($name,$component);
// test() adalah metode $behavior
$component->test();

Perilaku yang dilampirkan dapat diakses seperti layaknya properti komponen. Sebagai contoh, jika perilaku bernama tree dilampirkan ke komponen, kita bisa memperoleh referensi ke obyek perilaku ini menggunakan:

$behavior=$component->tree;
// sama dengan kode berikut:
// $behavior=$component->asa('tree');

Sebuah perilaku dapat dimatikan sementara agar metodenya tidak tersedia pada komponen. Sebagai contoh,

$component->disableBehavior($name);
// pernyataan berikut akan memunculkan eksepsi
$component->test();
$component->enableBehavior($name);
// ia bekerja sekarang
$component->test();

Dimungkinkan bahwa dua perilaku dilampirkan ke komponen yang sama yang memiliki nama metode yang sama. Dalam hal ini, perilaku metode pertama yang akan diprioritaskan.

Ketika dipakai bersama dengan event, perilaku bahkan lebih bertenaga. Sebuah perilaku, bila dilampirkan ke sebuah komponen dapat melampirkan beberapa metodenya ke beberapa event komponen. Dengan melakukan itu, perilaku mendapat kesempatan untuk mengawasi atau mengubah alur eksekusi normal komponen.

Tampilan

Tampilan (view) adalah naskah PHP yang berisi terutama elemen antar muka pengguna. Ia bisa berisi pernyataan PHP, tapi direkomendasikan bahwa pernyataan ini tidak mengubah model data dan harus tetap relatif sederhana. Untuk semangat pemisahan logika dan penyajian, bagian besar logika harus ditempatkan dalam kontroler atau model daripada tampilan.

Tampilan memiliki nama yang dipakai untuk mengidentifikasi file naskah tampilan saat penyiapan. Nama tampilan sama seperti nama file naskah tampilan. Sebagai contoh, tampilan edit merujuk pada file naskah bernama seperti edit.php. Untuk menyiapkan tampilan, pangil CController::render() dengan nama tampilan. Metode akan mencari file tampilan terkait di bawah direktori protected/views/ControllerID.

Di dalam naskah tampilan, kita dapat mengakses turunan kontroler menggunakan $this. Selanjutnya kita bisa menarik setiap properti kontroler dengan mengevaluasi $this->propertyName dalam tampilan.

Kita juga bisa menggunakan pendekatan dorong berikut guna mengoper data ke tampilan:

$this->render('edit', array(
   'var1'=>$value1,
   'var2'=>$value2,
));

Dalam contoh di atas, metode render() akan mengurai parameter array kedua ke dalam variabel. Hasilnya, dalam naskah tampilan kita dapat mengakses variabel lokal $var1 dan $var2.

Tata Letak

Tata letak adalah tampilan khusus yang dipakai untuk mendekorasi tampilan. Biasanya berisi bagian antar muka pengguna yang umum diantara beberapa tampilan. Sebagai contoh, tata letak mungkin berisi bagian header dan footer serta menyertakan tampilan konten diantarana,

......header di sini......
php echo $content; ?>
......footer di sini......

di mana $content menyimpan hasil pembuatan tampilan konten.

Tata letak secara implisit diterapkan saat memanggil render(). Secara standar, naskah tampilan protected/views/layouts/main.php dipakai sebagai tata letak. Ini bisa dikustomisasi dengan mengubah baik CWebApplication::layout ataupun CController::layout. Sebaliknya, untuk menyiapkan tampilan tanpa menerapkan tata letak apapun, panggil renderPartial().

Widget

Widget adalah turunan dari CWidget atau anak kelasnya. Komponen yang terutama ditujukan guna keperluan penyajian. Widget biasanya disertakan dalam naskah tampilan untuk menghasilkan beberapa antar muka pengguna yang kompleks dan berdiri sendiri. Sebagai contoh, widget kalender bisa dipakai untuk menyiapkan antar muka kalender pengguna yang kompleks. Widget menghidupkan pemakaian kembali yang lebih baik dalam antar muka pengguna.

Untuk menggunakan widget, lakukan seperti berikut dalam naskah tampilan:

 $this->beginWidget('path.to.WidgetClass'); ?>
...konten body yang dapat ditangkap oleh widget...
php $this->endWidget(); ?>

atau

 $this->widget('path.to.WidgetClass'); ?>

Contoh kedua dipakai saat widget tidak memerlukan konten body apapun.

Widget dapat dikonfigurasi untuk mengkustomisasi perilakunya. Ini dilakukan dengan menyetel nilai properti awalnya ketika memanggil CBaseController::beginWidget atau CBaseController::widget. Sebagai contoh, ketika menggunakan widget CMaskedTextField, kita ingin menetapkan pelapisan agar dipakai. Kita dapat melakukannya dengan mengoper array nilai awal properti itu sebagai berikut, di mana kunci array adalah nama properti dan nilai array adalah nilai awal pada properti widget terkait:

$this->widget('CMaskedTextField',array(
   'mask'=>'99/99/9999'
));
?>

Untuk mendefinisikan widget baru, perluas CWidget dan timpa metode init() dan run():

class MyWidget extends CWidget
{
   public function init()
   {
       // metode ini dipanggil oleh CController::beginWidget()
   }

   public function run()
   {
       // metode ini dipanggil oleh CController::endWidget()
   }
}

Seperti halnya kontroler, widget juga bisa memiliki tampilan sendiri. Standarnya, file tampilan widget ditempatkan di bawah subdirektori views pada direktori yang berisi file kelas widget. Tampilan ini disiapkan dengan memanggil CWidget::render(), mirip dengan pemanggilan kontroler. Perbedaannya tidak ada tata letak yang akan diterapkan pada tampilan widget.

Tampilan Sistem

Tampilan sistem merujuk pada tampilan yang dipakai oleh Yii untuk menampilkan kesalahan dan pencatatan informasi. Sebagai contoh, ketika permintaan pengguna untuk kontroler atau aksi yang tidak ada, Yii akan memunculkan eksepsi yang menjelaskan kesalahan. Yii menampilkan eksepsi menggunakan tampilan sistem tertentu.

Penamaan tampilan sistem mengikuti beberapa aturan. Nama seperti errorXXX merujuk pada tampilan untuk menampilkan CHttpException dengan kode kesalahan XXX. Sebagai contoh, jika CHttpException dimunculkan dengan kode kesalahan 404, tampilan error404 akan diperlihatkan.

Yii menyediakan satu set tampilan sistem standar yang ditempatkan di bawah framework/views. Ini bisa dikustomisasi dengan membuat file tampilan yang sama dengan nama yang sama di bawah protected/views/system.