应用组件

应用主体是服务定位器，它部署一组提供各种不同功能的 应用组件 来处理请求。例如，urlManager组件负责处理网页请求路由到对应的控制器。db组件提供数据库相关服务等等。

在同一个应用中，每个应用组件都有一个独一无二的 ID 用来区分其他应用组件，你可以通过如下表达式访问应用组件。

\Yii::$app->componentID

例如，可以使用 \Yii::$app->db 来获取到已注册到应用的 yii\db\Connection，使用 \Yii::$app->cache 来获取到已注册到应用的 yii\caching\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;
        },
    ],
]

Info: 请谨慎注册太多应用组件，应用组件就像全局变量，使用太多可能加大测试和维护的难度。一般情况下可以在需要时再创建本地组件。

引导启动组件

上面提到一个应用组件只会在第一次访问时实例化，如果处理请求过程没有访问的话就不实例化。有时你想在每个请求处理过程都实例化某个组件即便它不会被访问，可以将该组件ID加入到应用主体的 yii\base\Application::bootstrap 属性中。

例如, 如下的应用主体配置保证了 log 组件一直被加载。

[
    'bootstrap' => [
        // 将 log 组件 ID 加入引导让它始终载入
        'log',
    ],
    'components' => [
        'log' => [
            // "log" 组件的配置
        ],
    ],
]

核心应用组件

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

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

yii\web\AssetManager: 管理资源包和资源发布，详情请参考管理资源一节。
yii\db\Connection: 代表一个可以执行数据库操作的数据库连接，注意配置该组件时必须指定组件类名和其他相关组件属性，如yii\db\Connection::dsn。详情请参考数据访问对象一节。
yii\base\Application::errorHandler: 处理 PHP 错误和异常，详情请参考错误处理一节。
yii\i18n\Formatter: 格式化输出显示给终端用户的数据，例如数字可能要带分隔符，日期使用长格式。详情请参考格式化输出数据一节。
yii\i18n\I18N: 支持信息翻译和格式化。详情请参考国际化一节。
yii\log\Dispatcher: 管理日志对象。详情请参考日志一节。
yii\swiftmailer\Mailer: 支持生成邮件结构并发送，详情请参考邮件一节。
yii\base\Application::response: 代表发送给用户的响应，详情请参考响应一节。
yii\base\Application::request: 代表从终端用户处接收到的请求，详情请参考请求一节。
yii\web\Session: 代表会话信息，仅在yii\web\Application 网页应用中可用，详情请参考 Sessions (会话) and Cookies 一节。
yii\web\UrlManager: 支持URL地址解析和创建，详情请参考 URL 解析和生成一节。
yii\web\User: 代表认证登录用户信息，仅在yii\web\Application 网页应用中可用，详情请参考认证一节。
yii\web\View: 支持渲染视图，详情请参考 Views 一节。

5.0 KiB Raw Blame History

应用组件

引导启动组件

核心应用组件

5.0 KiB

Raw Blame History