组件
组件是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]类强制实现如下生命周期:
- 在构造函数里实现预初始化,可以在这个时候设定默认的属性值
- 通过$config配置对象,在构造函数里通过对象配置可以覆盖默认值
- 在[yii\base\Object::init()|init()]方法里,进行初始化后的配置。可以在init方法里实现例行检查和属性正常化检查
- 对象方法调用
开始的三个阶段都在构造函数里实现,这意味着当你得到一个对象的实例时,它已经被初始化为适当的状态,可以被放心的使用。