# 应用组件
应用主体是[服务定位器](http://www.yiichina.com/doc/guide/2.0/concept-service-locator),它部署一组提供各种不同功能的 *应用组件* 来处理请求。 例如,`urlManager`组件负责处理网页请求路由到对应的控制器。`db`组件提供数据库相关服务等等。
在同一个应用中,每个应用组件都有一个独一无二的 ID 用来区分其他应用组件,你可以通过如下表达式访问应用组件。
~~~
\Yii::$app->componentID
~~~
例如,可以使用 `\Yii::$app->db` 来获取到已注册到应用的 yii\db\Connection, 使用 `\Yii::$app->cache` 来获取到已注册到应用的 yii\caching\Cache。
第一次使用以上表达式时候会创建应用组件实例,后续再访问会返回此实例,无需再次创建。
应用组件可以是任意对象,可以在 [应用主体配置](http://www.yiichina.com/doc/guide/2.0/structure-applications#application-configurations)配置 yii\base\Application::components 属性 . 例如:
~~~
[
'components' => [
// 使用类名注册 "cache" 组件
'cache' => 'yii\caching\ApcCache',
// 使用配置数组注册 "db" 组件
'db' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=demo',
'username' => 'root',
'password' => '',
],
// 使用函数注册"search" 组件
'search' => function () {
return new app\components\SolrService;
},
],
]
~~~
> 补充:请谨慎注册太多应用组件,应用组件就像全局变量,使用太多可能加大测试和维护的难度。 一般情况下可以在需要时再创建本地组件。
## 引导启动组件
上面提到一个应用组件只会在第一次访问时实例化,如果处理请求过程没有访问的话就不实例化。 有时你想在每个请求处理过程都实例化某个组件即便它不会被访问, 可以将该组件ID加入到应用主体的 yii\base\Application::bootstrap 属性中。
例如, 如下的应用主体配置保证了 `log` 组件一直被加载。
~~~
[
'bootstrap' => [
// 将 log 组件 ID 加入引导让它始终载入
'log',
],
'components' => [
'log' => [
// "log" 组件的配置
],
],
]
~~~
## 核心应用组件
Yii 定义了一组固定ID和默认配置的 *核心* 组件,例如 yii\web\Application::request 组件 用来收集用户请求并解析 [路由](http://www.yiichina.com/doc/guide/2.0/runtime-routing); yii\base\Application::db 代表一个可以执行数据库操作的数据库连接。 通过这些组件,Yii应用主体能处理用户请求。
下面是预定义的核心应用组件列表,可以和普通应用组件一样配置和自定义它们。 当你配置一个核心组件,不指定它的类名的话就会使用Yii默认指定的类。
* yii\web\AssetManager: 管理资源包和资源发布,详情请参考 [管理资源](http://www.yiichina.com/doc/guide/2.0/output-assets) 一节。
* yii\db\Connection: 代表一个可以执行数据库操作的数据库连接, 注意配置该组件时必须指定组件类名和其他相关组件属性,如yii\db\Connection::dsn。 详情请参考 [数据访问对象](http://www.yiichina.com/doc/guide/2.0/db-dao) 一节。
* yii\base\Application::errorHandler: 处理 PHP 错误和异常, 详情请参考 [错误处理](http://www.yiichina.com/doc/guide/2.0/tutorial-handling-errors) 一节。
* yii\i18n\Formatter: 格式化输出显示给终端用户的数据,例如数字可能要带分隔符, 日期使用长格式。详情请参考 [格式化输出数据](http://www.yiichina.com/doc/guide/2.0/output-formatting)一节。
* yii\i18n\I18N: 支持信息翻译和格式化。详情请参考 [国际化](http://www.yiichina.com/doc/guide/2.0/tutorial-i18n) 一节。
* yii\log\Dispatcher: 管理日志对象。详情请参考 [日志](http://www.yiichina.com/doc/guide/2.0/tutorial-logging) 一节。
* yii\swiftmailer\Mailer: 支持生成邮件结构并发送,详情请参考 [邮件](http://www.yiichina.com/doc/guide/2.0/tutorial-mailing) 一节。
* yii\base\Application::response: 代表发送给用户的响应, 详情请参考 [响应](http://www.yiichina.com/doc/guide/2.0/runtime-responses) 一节。
* yii\base\Application::request: 代表从终端用户处接收到的请求, 详情请参考 [请求](http://www.yiichina.com/doc/guide/2.0/runtime-requests) 一节。
* yii\web\Session: 代表会话信息,仅在yii\web\Application 网页应用中可用, 详情请参考 [Sessions (会话) and Cookies](http://www.yiichina.com/doc/guide/2.0/runtime-sessions-cookies) 一节。
* yii\web\UrlManager: 支持URL地址解析和创建, 详情请参考 [URL 解析和生成](http://www.yiichina.com/doc/guide/2.0/runtime-url-handling) 一节。
* yii\web\User: 代表认证登录用户信息,仅在yii\web\Application 网页应用中可用, 详情请参考 [认证](http://www.yiichina.com/doc/guide/2.0/security-authentication) 一节。
* yii\web\View: 支持渲染视图,详情请参考 [Views](http://www.yiichina.com/doc/guide/2.0/structure-views) 一节。
- 介绍(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)