執行應用

安裝 Yii 後，就有了一個執行中的 Yii 應用，根據組態的不同，可以通過 `http://hostname/basic/web/index.php` 或 `http://hostname/index.php` 存取。本章節將介紹應用的內建功能，如何組織程式碼，以及一般情況下應用如何處理請求。

> 補充：為簡單起見，在整個“入門”板塊都假定你已經把 `basic/web` 設為 Web 伺服器根目錄並組態完畢，你存取應用的地址會是 `http://lostname/index.php` 或類似的。請按需調整 URL。

功能

一個安裝完的基本應用包含四頁：

* 主頁，當你存取 `http://hostname/index.php` 時顯示,
* “About” 頁，
* “Contact” 頁，顯示一個聯絡表單，允許終端使用者通過 Email 聯絡你，
* “Login” 頁，顯示一個登入表單，用來驗證終端使用者。試著用 “admin/admin” 登入，你可以看到當前是登入狀態，已經可以“退出登入”了。

這些頁面使用同一個頭部和尾部。頭部包含了一個可以在不同頁面間切換的導航欄。
在瀏覽器底部可以看到一個工具列。這是 Yii 提供的很有用的[偵錯工具](tool-debugger.md)，可以記錄並顯示大量的偵錯資訊，例如紀錄檔資訊，響應狀態，資料庫查詢等等。

應用結構 ?

應用中最重要的目錄和檔案（假設應用根目錄是 `basic`）：

basic/                  應用根目錄
    composer.json       Composer 組態檔案, 描述包資訊
    config/             包含應用組態及其它組態
        console.php     控制台應用組態資訊
        web.php         Web 應用組態資訊
    commands/           包含控制台命令類
    controllers/        包含控制器類
    models/             包含模型類
    runtime/            包含 Yii 在執行時生成的檔案，例如紀錄檔和快取檔案
    vendor/             包含已經安裝的 Composer 包，包括 Yii 框架自身
    views/              包含檢視檔案
    web/                Web 應用根目錄，包含 Web 入口檔案
        assets/         包含 Yii 發布的資原始檔（javascript 和 css）
        index.php       應用入口檔案
    yii                 Yii 控制台命令執行指令碼

一般來說，應用中的檔案可被分為兩類：在 `basic/web` 下的和在其它目錄下的。前者可以直接通過 HTTP 存取（例如瀏覽器），後者不能也不應該被直接存取。

Yii 實現了[模型-檢視-控制器 (MVC)](http://wikipedia.org/wiki/Model-view-controller)設計模式，這點在上述目錄結構中也得以體現。 `models` 目錄包含了所有[模型類]，`views` 目錄包含了所有[檢視指令碼]，`controllers` 目錄包含了所有[控制器類]。

以下圖表展示了一個應用的靜態結構：
[應用靜態結構]

每個應用都有一個入口指令碼 `web/index.php`，這是整個應用中唯一可以存取的 PHP 指令碼。入口指令碼接受一個 Web 請求並建立[應用]範例去處理它。 [應用]在它的[組建]輔助下解析請求，並分派請求至 MVC 元素。[檢視]使用[小部件]去建立複雜和動態的使用者介面。

請求生命週期

以下圖表展示了一個應用如何處理請求：

[請求生命週期]

1. 使用者向[入口指令碼]`web/index.php` 發起請求。
2. 入口指令碼載入應用[組態]並建立一個[應用]範例去處理請求。
3. 應用通過[請求]元件解析請求的[路由]。
4. 應用建立一個[控制器]範例去處理請求。
5. 控制器建立一個[操作]範例並針對操作執行過濾器。
6. 如果任何一個過濾器返回失敗，則操作退出。
7. 如果所有過濾器都通過，操作將被執行。
8. 操作會載入一個資料模型，或許是來自資料庫。
9. 操作會渲染一個檢視，把資料模型提供給它。
10. 渲染結果返回給[響應]元件。
11. 響應元件傳送渲染結果給使用者瀏覽器。