# 主題
主題是一種將當前的一套視圖?[views](http://www.yiichina.com/doc/guide/2.0/structure-views)?替換為另一套視圖，而無需更改視圖渲染代碼的方法。 你可以使用主題來系統地更改應用的外觀和體驗。
要使用主題，你得配置?`view`?應用組件的 yii\base\View::theme 屬性。 這個屬性配置了一個 yii\base\Theme 對象，這個對象用來控制視圖文件怎樣被替換。 你主要應該指明下面的 yii\base\Theme 屬性：
* yii\base\Theme::basePath：指定包含主題資源（CSS, JS, images, 等等）的基準目錄。
* yii\base\Theme::baseUrl：指定主題資源的基準URL。
* yii\base\Theme::pathMap：指定視圖文件的替換規則。更多細節將在下面介紹。
例如，如果你在?`SiteController`?里面調用?`$this->render('about')`，那你將渲染視圖文件?`@app/views/site/about.php`。 然而，如果你在下面的應用配置中開啟了主題功能，那么`@app/themes/basic/site/about.php`?文件將會被渲染。
~~~
return [
'components' => [
'view' => [
'theme' => [
'basePath' => '@app/themes/basic',
'baseUrl' => '@web/themes/basic',
'pathMap' => [
'@app/views' => '@app/themes/basic',
],
],
],
],
];
~~~
> 信息：主題支持路徑別名。當我們在做視圖替換的時候， 路徑別名將被轉換成實際的文件路徑或者URL。
你可以通過 yii\base\View::theme 屬性訪問 yii\base\Theme 對象。例如，在一個視圖文件里，你可以寫下面的代碼， 因為?`$this`?指向視圖對象：
~~~
$theme = $this->theme;
// returns: $theme->baseUrl . '/img/logo.gif'
$url = $theme->getUrl('img/logo.gif');
// returns: $theme->basePath . '/img/logo.gif'
$file = $theme->getPath('img/logo.gif');
~~~
yii\base\Theme::pathMap 屬性控制如何替換視圖文件。它是一個鍵值對數組，其中， 鍵是原本的視圖路徑，而值是相應的主題視圖路徑。 替換是基于部分匹配的：如果視圖路徑以 yii\base\Theme::pathMap 數組的 任何一個鍵為起始，那么匹配部分將被相應的值所替換。 使用上面配置的例子，因為?`@app/views/site/about.php`?中的起始部分與鍵?`@app/views`?匹配， 它將被替換成`@app/themes/basic/site/about.php`。
## 主題化模塊
要主題化模塊，yii\base\Theme::pathMap 可以配置成下面這樣：
~~~
'pathMap' => [
'@app/views' => '@app/themes/basic',
'@app/modules' => '@app/themes/basic/modules', // <-- !!!
],
~~~
它允許你將?`@app/modules/blog/views/comment/index.php`?主題化成`@app/themes/basic/modules/blog/views/comment/index.php`。
## 主題化小部件
要主題化小部件，你可以像下面這樣配置 yii\base\Theme::pathMap：
~~~
'pathMap' => [
'@app/views' => '@app/themes/basic',
'@app/widgets' => '@app/themes/basic/widgets', // <-- !!!
],
~~~
這將允許你將?`@app/widgets/currency/views/index.php`?主題化成?`@app/themes/basic/widgets/currency/index.php`。
## 主題繼承
有的時候，你可能想要定義一個基本的主題，其中包含一個基本的應用外觀和體驗，然后根據當前的節日，你可能想要稍微地改變一下外觀和體驗。 這個時候，你就可以使用主題繼承實現這一目標，主題繼承是通過一個單視圖路徑去映射多個目標， 例如，
~~~
'pathMap' => [
'@app/views' => [
'@app/themes/christmas',
'@app/themes/basic',
],
]
~~~
在這種情況下，視圖?`@app/views/site/index.php`?將被主題化成?`@app/themes/christmas/site/index.php`?或者`@app/themes/basic/site/index.php`， 這取決于哪個主題文件存在。假如都存在，那么第一個將被優先使用。在現實情況中， 你會將大部分的主題文件放在?`@app/themes/basic`?里，而一些自定義的放在?`@app/themes/christmas`里。
- 介紹（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）