運行應用

安裝 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. 響應組件發送渲染結果給用戶瀏覽器。