# 運行應用
安裝 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 提供的很有用的[調試工具](http://www.yiichina.com/doc/guide/2.0/tool-debugger)，可以記錄并顯示大量的調試信息，例如日志信息，響應狀態，數據庫查詢等等。
## 應用結構
應用中最重要的目錄和文件（假設應用根目錄是?`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`?目錄包含了所有[模型類](http://www.yiichina.com/doc/guide/2.0/structure-models)，`views`?目錄包含了所有[視圖腳本](http://www.yiichina.com/doc/guide/2.0/structure-views)，`controllers`?目錄包含了所有[控制器類](http://www.yiichina.com/doc/guide/2.0/structure-controllers)。
以下圖表展示了一個應用的靜態結構：
每個應用都有一個入口腳本?`web/index.php`，這是整個應用中唯一可以訪問的 PHP 腳本。入口腳本接受一個 Web 請求并創建[應用](http://www.yiichina.com/doc/guide/2.0/structure-application)實例去處理它。?[應用](http://www.yiichina.com/doc/guide/2.0/structure-applications)在它的[組建](http://www.yiichina.com/doc/guide/2.0/concept-components)輔助下解析請求，并分派請求至 MVC 元素。[視圖](http://www.yiichina.com/doc/guide/2.0/structure-views)使用[小部件](http://www.yiichina.com/doc/guide/2.0/structure-widgets)去創建復雜和動態的用戶界面。
## 請求生命周期
以下圖表展示了一個應用如何處理請求：
1. 用戶向[入口腳本](http://www.yiichina.com/doc/guide/2.0/structure-entry-scripts)?`web/index.php`?發起請求。
2. 入口腳本加載應用[配置](http://www.yiichina.com/doc/guide/2.0/concept-configurations)并創建一個[應用](http://www.yiichina.com/doc/guide/2.0/structure-applications)實例去處理請求。
3. 應用通過[請求](http://www.yiichina.com/doc/guide/2.0/runtime-request)組件解析請求的[路由](http://www.yiichina.com/doc/guide/2.0/runtime-routing)。
4. 應用創建一個[控制器](http://www.yiichina.com/doc/guide/2.0/structure-controllers)實例去處理請求。
5. 控制器創建一個[操作](http://www.yiichina.com/doc/guide/2.0/structure-controllers)實例并針對操作執行過濾器。
6. 如果任何一個過濾器返回失敗，則操作退出。
7. 如果所有過濾器都通過，操作將被執行。
8. 操作會加載一個數據模型，或許是來自數據庫。
9. 操作會渲染一個視圖，把數據模型提供給它。
10. 渲染結果返回給[響應](http://www.yiichina.com/doc/guide/2.0/runtime-responses)組件。
11. 響應組件發送渲染結果給用戶瀏覽器。
- 介紹（Introduction）
- 關于 Yii（About Yii）
- 從 Yii 1.1 升級（Upgrading from Version 1.1）
- 入門（Getting Started）
- 安裝 Yii（Installing Yii）
- 運行應用（Running Applications）
- 第一次問候（Saying Hello）
- 使用 Forms（Working with Forms）
- 玩轉 Databases（Working with Databases）
- 用 Gii 生成代碼（Generating Code with Gii）
- 更上一層樓（Looking Ahead）
- 應用結構（Application Structure）
- 結構概述（Overview）
- 入口腳本（Entry Scripts）
- 應用（Applications）
- 應用組件（Application Components）
- 控制器（Controllers）
- 模型（Models）
- 視圖（Views）
- 模塊（Modules）
- 過濾器（Filters）
- 小部件（Widgets）
- 前端資源（Assets）
- 擴展（Extensions）
- 請求處理（Handling Requests）
- 運行概述（Overview）
- 引導（Bootstrapping）
- 路由引導與創建 URL（Routing and URL Creation）
- 請求（Requests）
- 響應（Responses）
- Sessions and Cookies
- 錯誤處理（Handling Errors）
- 日志（Logging）
- 關鍵概念（Key Concepts）
- 組件（Components）
- 屬性（Properties）
- 事件（Events）
- 行為（Behaviors）
- 配置（Configurations）
- 別名（Aliases）
- 類自動加載（Class Autoloading）
- 服務定位器（Service Locator）
- 依賴注入容器（Dependency Injection Container）
- 配合數據庫工作（Working with Databases）
- 數據庫訪問（Data Access Objects）: 數據庫連接、基本查詢、事務和模式操作
- 查詢生成器（Query Builder）: 使用簡單抽象層查詢數據庫
- 活動記錄（Active Record）: 活動記錄對象關系映射（ORM），檢索和操作記錄、定義關聯關系
- 數據庫遷移（Migrations）: 在團體開發中對你的數據庫使用版本控制
- Sphinx
- Redis
- MongoDB
- ElasticSearch
- 接收用戶數據（Getting Data from Users）
- 創建表單（Creating Forms）
- 輸入驗證（Validating Input）
- 文件上傳（Uploading Files）
- 收集列表輸入（Collecting Tabular Input）
- 多模型同時輸入（Getting Data for Multiple Models）
- 顯示數據（Displaying Data）
- 格式化輸出數據（Data Formatting）
- 分頁（Pagination）
- 排序（Sorting）
- 數據提供器（Data Providers）
- 數據小部件（Data Widgets）
- 操作客戶端腳本（Working with Client Scripts）
- 主題（Theming）
- 安全（Security）
- 認證（Authentication）
- 授權（Authorization）
- 處理密碼（Working with Passwords）
- 客戶端認證（Auth Clients）
- 安全領域的最佳實踐（Best Practices）
- 緩存（Caching）
- 概述（Overview）
- 數據緩存（Data Caching）
- 片段緩存（Fragment Caching）
- 分頁緩存（Page Caching）
- HTTP 緩存（HTTP Caching）
- RESTful Web 服務
- 快速入門（Quick Start）
- 資源（Resources）
- 控制器（Controllers）
- 路由（Routing）
- 格式化響應（Response Formatting）
- 授權驗證（Authentication）
- 速率限制（Rate Limiting）
- 版本化（Versioning）
- 錯誤處理（Error Handling）
- 開發工具（Development Tools）
- 調試工具欄和調試器（Debug Toolbar and Debugger）
- 使用 Gii 生成代碼（Generating Code using Gii）
- TBD 生成 API 文檔（Generating API Documentation）
- 測試（Testing）
- 概述（Overview）
- 搭建測試環境（Testing environment setup）
- 單元測試（Unit Tests）
- 功能測試（Functional Tests）
- 驗收測試（Acceptance Tests）
- 測試夾具（Fixtures）
- 高級專題（Special Topics）
- 高級應用模版（Advanced Project Template）
- 從頭構建自定義模版（Building Application from Scratch）
- 控制臺命令（Console Commands）
- 核心驗證器（Core Validators）
- 國際化（Internationalization）
- 收發郵件（Mailing）
- 性能優化（Performance Tuning）
- 共享主機環境（Shared Hosting Environment）
- 模板引擎（Template Engines）
- 集成第三方代碼（Working with Third-Party Code）
- 小部件（Widgets）
- Bootstrap 小部件（Bootstrap Widgets）
- jQuery UI 小部件（jQuery UI Widgets）
- 助手類（Helpers）
- 助手一覽（Overview）
- Array 助手（ArrayHelper）
- Html 助手（Html）
- Url 助手（Url）