目录 搜索
阅读前篇 简介 Yii 是什么 从 Yii 1.1 升级 入门 安装 Yii 运行应用 第一次问候 使用Forms 数据库应用 使用 Gii 生成代码 进阶 应用结构 概述 入口脚本 应用(Applications) 应用组件(Application Components) 控制器(Controllers) 模型(Models) 视图(views) 模块(Modules) 过滤器(Filters) 小部件(Widgets) 前端资源(Assets) 扩展(Extensions) 请求处理 运行概述 启动引导(Bootstrapping) 路由和创建URL 请求(Requests) 响应(Responses) Sessions 和 Cookies 错误处理(Handling Errors) 日志(Logging) 关键概念 组件(Component) 属性(Property) 事件(Events) 行为(Behaviors) 配置(Configurations) 别名(Aliases) 类自动加载(Autoloading) 服务定位器(Service Locator) 依赖注入容器(Dependency Injection Container) 配合数据库工作 数据库访问 (Data Access Objects) 查询生成器(Query Builder) 活动记录(Active Record) 数据库迁移(Migrations) Sphinx Redis MongoDB Elasticsearch 接收用户数据 创建表单(Creating Forms) 输入验证(Validating Input) 文件上传(Uploading Files) 收集列表输入(Collecting Tabular Input) 多模型的复合表单(Getting Data for Multiple Models) 显示数据 格式化输出数据(Data Formatting) 分页(Pagination) 排序(Sorting) 数据提供器(Data Providers) 数据小部件(Data Widgets) 客户端脚本使用(Working with Client Scripts) 主题(Theming) 安全 认证(Authentication) 授权(Authorization) 处理密码(Working with Passwords) 客户端认证(Auth Clients) 最佳安全实践(Best Practices) 缓存 概述 数据缓存 片段缓存 页面缓存 HTTP 缓存 RESTfull Web服务 快速入门(Quick Start) 资源(Resources) 控制器(Controllers) 路由(Routing) 格式化响应(Response Formatting) 授权认证(Authentication) 速率限制(Rate Limiting) 版本(Versioning) 错误处理(Error Handling) 开发工具 调试工具栏和调试器 使用Gii生成代码 生成API文档 测试 概述(Overview) 配置测试环境(Testing environment setup) 单元测试(Unit Tests) 功能测试(Function Tests) 验收测试(Acceptance Tests) 测试夹具(Fixtures) 高级专题 高级应用模板 创建自定义应用程序结构 控制台命令 核心验证器(Core Validators) 国际化 收发邮件 性能优化 共享主机环境 模板引擎 集成第三方代码 小部件 Bootstrap 小部件 Jquery UI 助手类 概述 Array 助手(ArrayHelper) Html 助手(Html) Url 助手(Url)
文字

应用组件

应用组件

应用主体是服务定位器,它部署一组提供各种不同功能的 应用组件 来处理请求。 例如,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;
        },
    ],
]

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

引导启动组件

上面提到一个应用组件只会在第一次访问时实例化,如果处理请求过程没有访问的话就不实例化。 有时你想在每个请求处理过程都实例化某个组件即便它不会被访问, 可以将该组件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 一节。
上一篇: 下一篇: