# 主题
主题是一种将当前的一套视图 [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）