運行應用


運行應用

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