Yii2.0应用组件
在同一个应用中,每个应用组件都有一个独一无二的 ID 用来区分其他应用组件,你可以通过如下表达式访问应用组件。
\Yii::$app->componentID
例如,可以使用 \Yii::$app->db 来获取到已注册到应用的 [[yii\db\Connection|DB connection]], 使用 \Yii::$app->cache 来获取到已注册到应用的 [[yii\caching\Cache|primary cache]]。
第一次使用以上表达式时候会创建应用组件实例,后续再访问会返回此实例,无需再次创建。
应用组件可以是任意对象,可以在 应用主体配置配置 [[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|bootstrap]] 属性中。
例如, 如下的应用主体配置保证了 log 组件一直被加载。
[ 'bootstrap' => [ // 将 log 组件 ID 加入引导让它始终载入 'log', ], 'components' => [ 'log' => [ // "log" 组件的配置 ], ], ]
核心应用组件
Yii 定义了一组固定ID和默认配置的 核心 组件,例如 [[yii\web\Application::request|request]] 组件 用来收集用户请求并解析 路由; [[yii\base\Application::db|db]] 代表一个可以执行数据库操作的数据库连接。 通过这些组件,Yii应用主体能处理用户请求。
下面是预定义的核心应用组件列表,可以和普通应用组件一样配置和自定义它们。 当你配置一个核心组件,不指定它的类名的话就会使用Yii默认指定的类。
[[yii\web\AssetManager|assetManager]]: 管理资源包和资源发布,详情请参考 管理资源 一节。
注意配置该组件时必须指定组件类名和其他相关组件属性,如[[yii\db\Connection::dsn]]。 详情请参考 数据访问对象 一节。
[[yii\base\Application::errorHandler|errorHandler]]: 处理 PHP 错误和异常, 详情请参考 错误处理 一节。
日期使用长格式。详情请参考 格式化输出数据 一节。
[[yii\i18n\I18N|i18n]]: 支持信息翻译和格式化。详情请参考 国际化 一节。
[[yii\log\Dispatcher|log]]: 管理日志对象。详情请参考 日志 一节。
[[yii\swiftmailer\Mailer|mail]]: 支持生成邮件结构并发送,详情请参考 邮件 一节。
详情请参考 响应 一节。
详情请参考 请求 一节。
[[yii\web\Session|session]]: 代表会话信息,仅在[[yii\web\Application|Web applications]] 网页应用中可用, 详情请参考Sessions (会话) and Cookies 一节。
详情请参考 URL 解析和生成 一节。
[[yii\web\User|user]]: 代表认证登录用户信息,仅在[[yii\web\Application|Web applications]] 网页应用中可用, 详情请参考认证一节。
[[yii\web\View|view]]: 支持渲染视图,详情请参考 Views 一节。