Yii2 框架核心概念之组件(手册翻译)

组件

组件是YII框架application(应用）的主要组成部分，它是 [yii\base\Component]的实例或者子类。组件有三个重要特征（功能）：

• 属性（properties）
• 事件（events)
• 行为（behaviors)

单独或者组合使用这些特征，可以让yii框架的类变得更加易用和可定制。举个例子，引入一个用户交互组件[yii\jui\DataPicker\data picker wigets],可以很轻松的在视图中生成一个日期选择控件(jquery ui date picker).

use yii\jui\DatePicker;

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

DatePicker挂件的属性很容易被修改，原因就在于他继承了类[yii\base\Componet]

尽管组件很强大，但是其开销也大于普通的类对象，原因在于组件需要额外的内存和CPU时间去处理事件(events)和行为(behaviors).如果你的组件不需要事件和行为这两个特征(功能),可以直接继承[yii\base\Object],这样你的组件在性能（效率）上和普通类对象一致，且支持属性(properties).

编写一个继承[yii\base\Component]或者[yii\base\Object]的类，需要遵循以下约定：

• 假设你重写了构造函数，必须定义一个参数$config,作为构造函数的最后一个参数，此参数被传递给父类的构造函数使用
• 在重写的构造函数的结尾必须调用父类的构造函数
• 假设你重写了[yii\base\Object::init()|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 = [])
    {
        // ... initialization before configuration is applied

        parent::__construct($config);
    }

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

        // ... initialization after configuration is applied
    }
}

遵循如下示例，可使你的组件在创建时属性即可被配置(初始化):

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

提示: 使用[Yii::createOject()]的方式看起来更加复杂，但是因为[Yii::createObject]是基于依赖注入的实现，因此更加强大

[yii\base\Object]类强制实现如下生命周期:

1. 在构造函数里实现预初始化，可以在这个时候设定默认的属性值
2. 通过$config配置对象，在构造函数里通过对象配置可以覆盖默认值
3. 在[yii\base\Object::init()|init()]方法里，进行初始化后的配置。可以在init方法里实现例行检查和属性正常化检查
4. 对象方法调用

开始的三个阶段都在构造函数里实现，这意味着当你得到一个对象的实例时，它已经被初始化为适当的状态，可以被放心的使用。