Yii2学习笔记系列10——Application Structure-Application Components(应用结构之应用组件)

四 14 四月 2016

应用组件

应用主体都是服务定位器,他们部署一系列的应用组件,用来提供可以处理请求的多个服务,例如,urlManager组件负责处理网页请求路由到对应的控制器,db组件提供数据库相关服务等。

在一个应用主体中,每个应用组件都包含一个唯一的ID用以区分其他的应用组件。你可以通过如下表达式访问应用组件:

\Yii::$app->componentID

例如你可以通过\Yii::$app->db获取数据库连接,通过\Yii::$app->cache获取已经注册到应用的yii\caching\Cache。

一个应用组件实例会在通过上述表达式第一次访问的时候创建,后续访问的时候将会返回同一个组件实例。

应用组件可以是任意对象,你可以通过配置应用配置文件中的yii\base\Application::$components属性来注册组件,例如:

<?php
[
    '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组件会一直被加载。

<?php
[
    'bootstrap' => [
        // 将log组件ID加入引导,始终载入
        'log',
    ],
    'components' => [
        'log' => [
            // "log" 组件的配置
        ],
    ],
]
?>
核心应用组件

Yii定义了一组固定ID和默认配置的核心组件,例如yii\web\Application::request组件用来收集用户请求并解析路由;yii\base\Application::db代表一个可以执行数据库操作的数据库连接。在这些组件的帮助下,Yii的应用主体得以处理用户请求。

下面是Yii预定义的核心应用组件列表,核心组件可以和普通应用组件一样进行配置和自定义。当你配置一个核心组件时,如果不指定它的类名的话就会使用默认指定的类。

  • assetManager:管理资源包和资源发布,详情可以参考资源管理一节。
  • db:提供一个可以执行数据库操作的数据库连接,注意配置该组件时必须指定组件类名和其他相关组件属性,如yii\base\Application::dsn,详情可以参考数据库访问对象一节。
  • errorHandler:处理PHP错误和异常,详情参考错误处理
  • formatter:格式化要展示给用户看的数据。例如数字的分隔符,日期格式等等,详情请参考格式化输出一节。
  • i18n:支持信息翻译和格式化,详情请参考国际化一节。
  • log:管理log对象,详情参考日志一节。
  • mail:支持邮件的构成和发送,详情参考邮件一节。
  • response:表示返回给终端用户的响应,详情参考响应一节。
  • request:表示从终端用户接收到的请求,详情参考请求一节。
  • session:表示session会话信息,该组件只在Web应用(即网页应用)下可用,详情参考Session会话和Cookies一节
  • urlManager:支持URL地址的解析和创建,详情参考一节。
  • user:表示用户授权信息,该组件只在Web应用下可用,详情参考应用一节。
  • Views:支持视图的渲染,详情参考视图一节。

Category: PHP Develop

Comments