当继承 yii\base\Component 或 yii\base\Object 时,推荐你使用如下的编码风格:
- 若你需要重写构造方法(Constructor),传入
$config
作为构造器方法最后一个参数,然后把它传递给父类的构造方法。 - 永远在你重写的构造方法结尾处调用一下父类的构造方法。
- 如果你重写了 yii\base\Object::init() 方法,请确保你在
init
方法的开头处调用了父类的init
方法。
例子如下:
<?php
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();
// 你的代码... 配置生效后的初始化过程
}
}
原因:
yii\base\Component继承自yii\base\Object,在yii\base\Object中有两个函数,
public function __construct($config = [])
{
//配置过程
if (!empty($config)) {
Yii::configure($this, $config);
}
//调用了init()函数
$this->init();
}
public function init()
{
}
注意配置过程的中的一句话,
Yii::configure($this, $config);
其中函数configure()如下所示,
public static function configure($object, $properties)
{
foreach ($properties as $name => $value) {
$object->$name = $value;
}
return $object;
}
该函数的作用就是将类$object中的属性按照$properties中的键值对一一赋值。
所以为了让组件在创建实例时能被正确的配置,请遵照以下操作流程:
// 方法一:
$component = new MyClass(1, 2, ['prop1' => 3, 'prop2' => 4]);
// 方法二:
$component = \Yii::createObject([
'class' => MyClass::className(),
'prop1' => 3,
'prop2' => 4,
], [1, 2]);
补充:尽管调用 Yii::createObject() 的方法看起来更加复杂,但这主要因为它更加灵活强大,它是基于依赖注入容器实现的。