Yii2中文手册
简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)
目录 搜索
阅读前篇 简介 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)

©
本文档使用 PHP中文网手册 发布

文字

组件（Component）

组件（Component）

组件是 Yii 应用的主要基石。是 yii\base\Component 类或其子类的实例。三个用以区分它和其它类的主要功能有：

  • 属性（Property）
  • 事件（Event）
  • 行为（Behavior）

或单独使用，或彼此配合，这些功能的应用让 Yii 的类变得更加灵活和易用。以小部件 yii\jui\DatePicker 来举例，这是个方便你在 视图 中生成一个交互式日期选择器的 UI 组件：

use yii\jui\DatePicker;

echo DatePicker::widget([
    'language' => 'zh-CN',
    'name'  => 'country',
    'clientOptions' => [
        'dateFormat' => 'yy-mm-dd',
    ],
]);

这个小部件继承自 yii\base\Component，它的各项属性改写起来会很容易。

正是因为组件功能的强大，他们比常规的对象（Object）稍微重量级一点，因为他们要使用额外的内存和 CPU 时间来处理 事件 和 行为。如果你不需要这两项功能，可以继承 yii\base\Object 而不是 yii\base\Component。这样组件可以像普通 PHP 对象一样高效，同时还支持属性（Property）功能。

当继承 yii\base\Component 或 yii\base\Object 时，推荐你使用如下的编码风格：

  • 若你需要重写构造方法（Constructor），传入 $config 作为构造器方法最后一个参数，然后把它传递给父类的构造方法。
  • 永远在你重写的构造方法结尾处调用一下父类的构造方法。
  • 如果你重写了 yii\base\Object::init() 方法，请确保你在 init 方法的开头处调用了父类的 init 方法。

例子如下：

namespace yii\components\MyClass;

use yii\base\Object;

class MyClass extends Object{
    public $prop1;
    public $prop2;

    public function __construct($param1, $param2, $config = [])
    {
        // ... 配置生效前的初始化过程

        parent::__construct($config);
    }

    public function init()
    {
        parent::init();

        // ... 配置生效后的初始化过程
    }
}

另外，为了让组件可以在创建实例时能被正确配置，请遵照以下操作流程：

$component = new MyClass(1, 2, ['prop1' => 3, 'prop2' => 4]);
// 方法二：$component = \Yii::createObject([
    'class' => MyClass::className(),
    'prop1' => 3,
    'prop2' => 4,
], [1, 2]);

补充：尽管调用 Yii::createObject() 的方法看起来更加复杂，但这主要因为它更加灵活强大，它是基于依赖注入容器实现的。

yii\base\Object 类执行时的生命周期如下：

  1. 构造方法内的预初始化过程。你可以在这儿给各属性设置缺省值。
  2. 通过 $config 配置对象。配置的过程可能会覆盖掉先前在构造方法内设置的默认值。
  3. 在 yii\base\Object::init() 方法内进行初始化后的收尾工作。你可以通过重写此方法，进行一些良品检验，属性的初始化之类的工作。
  4. 对象方法调用。
前三步都是在对象的构造方法内发生的。这意味着一旦你获得了一个对象实例，那么它就已经初始化就绪可供使用。
上一篇： 下一篇：