详解PHP的Yii框架中组件行为的属性注入和方法注入
行为的属性和方法注入原理
上面我们了解到了行为的用意在于将自身的属性和方法注入给所依附的类。 那么yii中是如何将一个行为 yii\base\behavior 的属性和方法, 注入到一个 yii\base\component 中的呢? 对于属性而言,是通过 __get() 和 __set() 魔术方法来实现的。 对于方法,是通过 __call() 方法。
属性的注入
以读取为例,如果访问 $component->property1 ,yii在幕后干了些什么呢? 这个看看 yii\base\component::__get()
public function __get($name) { $getter = 'get' . $name; if (method_exists($this, $getter)) { return $this->$getter(); } else { // 注意这个 else 分支的内容,正是与 yii\base\object::__get() 的 // 不同之处 $this->ensurebehaviors(); foreach ($this->_behaviors as $behavior) { if ($behavior->cangetproperty($name)) { // 属性在行为中须为 public。否则不可能通过下面的形式访问呀。 return $behavior->$name; } } } if (method_exists($this, 'set' . $name)) { throw new invalidcallexception('getting write-only property: ' . get_class($this) . '::' . $name); } else { throw new unknownpropertyexception('getting unknown property: ' . get_class($this) . '::' . $name); } }
重点来看 yii\base\compoent::__get() 与 yii\base\object::__get() 的不同之处。 就是在于对于未定义getter函数之后的处理, yii\base\object 是直接抛出异常, 告诉你想要访问的属性不存在之类。 但是 yii\base\component 则是在不存在getter之后,还要看看是不是注入的行为的属性:
首先,调用了 $this->ensurebehaviors() 。这个方法已经在前面讲过了,主要是确保行为已经绑定。
在确保行为已经绑定后,开始遍历 $this->_behaviors 。 yii将类所有绑定的行为都保存在 yii\base\compoent::$_behaviors[] 数组中。
最后,通过行为的 cangetproperty() 判断这个属性, 是否是所绑定行为的可读属性,如果是,就返回这个行为的这个属性 $behavior->name 。 完成属性的读取。 至于 cangetproperty() 已经在 :ref::property 部分已经简单讲过了, 后面还会有针对性地一个介绍。
对于setter,代码类似,这里就不占用篇幅了。
方法的注入
与属性的注入通过 __get() __set() 魔术方法类似, yii通过 __call() 魔术方法实现对行为中方法的注入:
public function __call($name, $params) { $this->ensurebehaviors(); foreach ($this->_behaviors as $object) { if ($object->hasmethod($name)) { return call_user_func_array([$object, $name], $params); } } throw new unknownmethodexception('calling unknown method: ' . get_class($this) . "::$name()"); }
从上面的代码中可以看出,yii还是先是调用了 $this->ensurebehaviors() 确保行为已经绑定。
然后,也是遍历 yii\base\component::$_behaviros[] 数组。 通过 hasmethod() 方法判断方法是否存在。 如果所绑定的行为中要调用的方法存在,则使用php的 call_user_func_array() 调用之。 至于 hasmethod() 方法,我们后面再讲。
注入属性与方法的访问控制
在前面我们针对行为中public和private、protected的成员在所绑定的类中是否可访问举出了具体例子。 这里我们从代码层面解析原因。
在上面的内容,我们知道,一个属性可不可访问,主要看行为的 cangetproperty() 和 cansetproperty() 。 而一个方法可不可调用,主要看行为的 hasmethod() 。 由于 yii\base\behavior 继承自我们的老朋友 yii\base\object ,所以上面提到的三个判断方法, 事实上代码都在 object 中。我们一个一个来看:
public function cangetproperty($name, $checkvars = true) { return method_exists($this, 'get' . $name) || $checkvars && property_exists($this, $name); } public function cansetproperty($name, $checkvars = true) { return method_exists($this, 'set' . $name) || $checkvars && property_exists($this, $name); } public function hasmethod($name) { return method_exists($this, $name); }
这三个方法真的谈不上复杂。对此,我们可以得出以下结论:
当向component绑定的行为读取(写入)一个属性时,如果行为为该属性定义了一个getter (setter),则可以访问。 或者,如果行为确实具有该成员变量即可通过上面的判断,此时,该成员变量可为 public, private, protected。 但最终只有 public 的成员变量才能正确访问。原因在上面讲注入的原理时已经交待了。
当调用component绑定的行为的一个方法时,如果行为已经定义了该方法,即可通过上面的判断。 此时,这个方法可以为 public, private, protected。 但最终只有 public 的方法才能正确调用。如果你理解了上一款的原因,那么这里也就理解了。
依赖注入容器
依赖注入(dependency injection,di)容器就是一个对象,它知道怎样初始化并配置对象及其依赖的所有对象。martin 的文章 已经解释了 di 容器为什么很有用。这里我们主要讲解 yii 提供的 di 容器的使用方法。
依赖注入
yii 通过 yii\di\container 类提供 di 容器特性。它支持如下几种类型的依赖注入:
- 构造方法注入;
- setter 和属性注入;
- php 回调注入.
- 构造方法注入
在参数类型提示的帮助下,di 容器实现了构造方法注入。当容器被用于创建一个新对象时,类型提示会告诉它要依赖什么类或接口。容器会尝试获取它所依赖的类或接口的实例,然后通过构造器将其注入新的对象。例如:
class foo { public function __construct(bar $bar) { } } $foo = $container->get('foo'); // 上面的代码等价于: $bar = new bar; $foo = new foo($bar);
setter 和属性注入
setter 和属性注入是通过配置提供支持的。当注册一个依赖或创建一个新对象时,你可以提供一个配置,该配置会提供给容器用于通过相应的 setter 或属性注入依赖。例如:
use yii\base\object; class foo extends object { public $bar; private $_qux; public function getqux() { return $this->_qux; } public function setqux(qux $qux) { $this->_qux = $qux; } } $container->get('foo', [], [ 'bar' => $container->get('bar'), 'qux' => $container->get('qux'), ]);
php 回调注入
这种情况下,容器将使用一个注册过的 php 回调创建一个类的新实例。回调负责解决依赖并将其恰当地注入新创建的对象。例如:
$container->set('foo', function () { return new foo(new bar); }); $foo = $container->get('foo');
注册依赖关系
可以用 yii\di\container::set() 注册依赖关系。注册会用到一个依赖关系名称和一个依赖关系的定义。依赖关系名称可以是一个类名,一个接口名或一个别名。依赖关系的定义可以是一个类名,一个配置数组,或者一个 php 回调。
$container = new \yii\di\container; // 注册一个同类名一样的依赖关系,这个可以省略。 $container->set('yii\db\connection'); // 注册一个接口 // 当一个类依赖这个接口时,相应的类会被初始化作为依赖对象。 $container->set('yii\mail\mailinterface', 'yii\swiftmailer\mailer'); // 注册一个别名。 // 你可以使用 $container->get('foo') 创建一个 connection 实例 $container->set('foo', 'yii\db\connection'); // 通过配置注册一个类 // 通过 get() 初始化时,配置将会被使用。 $container->set('yii\db\connection', [ 'dsn' => 'mysql:host=127.0.0.1;dbname=demo', 'username' => 'root', 'password' => '', 'charset' => 'utf8', ]); // 通过类的配置注册一个别名 // 这种情况下,需要通过一个 “class” 元素指定这个类 $container->set('db', [ 'class' => 'yii\db\connection', 'dsn' => 'mysql:host=127.0.0.1;dbname=demo', 'username' => 'root', 'password' => '', 'charset' => 'utf8', ]); // 注册一个 php 回调 // 每次调用 $container->get('db') 时,回调函数都会被执行。 $container->set('db', function ($container, $params, $config) { return new \yii\db\connection($config); }); // 注册一个组件实例 // $container->get('pagecache') 每次被调用时都会返回同一个实例。 $container->set('pagecache', new filecache);
tip: 如果依赖关系名称和依赖关系的定义相同,则不需要通过 di 容器注册该依赖关系。
通过 set() 注册的依赖关系,在每次使用时都会产生一个新实例。可以使用 yii\di\container::setsingleton() 注册一个单例的依赖关系:
$container->setsingleton('yii\db\connection', [ 'dsn' => 'mysql:host=127.0.0.1;dbname=demo', 'username' => 'root', 'password' => '', 'charset' => 'utf8', ]);
解决依赖关系
注册依赖关系后,就可以使用 di 容器创建新对象了。容器会自动解决依赖关系,将依赖实例化并注入新创建的对象。依赖关系的解决是递归的,如果一个依赖关系中还有其他依赖关系,则这些依赖关系都会被自动解决。
可以使用 yii\di\container::get() 创建新的对象。该方法接收一个依赖关系名称,它可以是一个类名,一个接口名或一个别名。依赖关系名或许是通过 set() 或 setsingleton() 注册的。你可以随意地提供一个类的构造器参数列表和一个configuration 用于配置新创建的对象。例如:
// "db" 是前面定义过的一个别名 $db = $container->get('db'); // 等价于: $engine = new \app\components\searchengine($apikey, ['type' => 1]); $engine = $container->get('app\components\searchengine', [$apikey], ['type' => 1]);
代码背后,di 容器做了比创建对象多的多的工作。容器首先将检查类的构造方法,找出依赖的类或接口名,然后自动递归解决这些依赖关系。
如下代码展示了一个更复杂的示例。userlister 类依赖一个实现了 userfinderinterface 接口的对象;userfinder 类实现了这个接口,并依赖于一个 connection 对象。所有这些依赖关系都是通过类构造器参数的类型提示定义的。通过属性依赖关系的注册,di 容器可以自动解决这些依赖关系并能通过一个简单的 get('userlister') 调用创建一个新的 userlister 实例。
namespace app\models; use yii\base\object; use yii\db\connection; use yii\di\container; interface userfinderinterface { function finduser(); } class userfinder extends object implements userfinderinterface { public $db; public function __construct(connection $db, $config = []) { $this->db = $db; parent::__construct($config); } public function finduser() { } } class userlister extends object { public $finder; public function __construct(userfinderinterface $finder, $config = []) { $this->finder = $finder; parent::__construct($config); } } $container = new container; $container->set('yii\db\connection', [ 'dsn' => '...', ]); $container->set('app\models\userfinderinterface', [ 'class' => 'app\models\userfinder', ]); $container->set('userlister', 'app\models\userlister'); $lister = $container->get('userlister'); // 等价于: $db = new \yii\db\connection(['dsn' => '...']); $finder = new userfinder($db); $lister = new userlister($finder);
实践中的运用
当在应用程序的入口脚本中引入 yii.php 文件时,yii 就创建了一个 di 容器。这个 di 容器可以通过 yii::$container 访问。当调用 yii::createobject() 时,此方法实际上会调用这个容器的 yii\di\container::get() 方法创建新对象。如上所述,di 容器会自动解决依赖关系(如果有)并将其注入新创建的对象中。因为 yii 在其多数核心代码中都使用了 yii::createobject() 创建新对象,所以你可以通过 yii::$container 全局性地自定义这些对象。
例如,你可以全局性自定义 yii\widgets\linkpager 中分页按钮的默认数量:
\yii::$container->set('yii\widgets\linkpager', ['maxbuttoncount' => 5]);
这样如果你通过如下代码在一个视图里使用这个挂件,它的 maxbuttoncount 属性就会被初始化为 5 而不是类中定义的默认值 10。
echo \yii\widgets\linkpager::widget();
然而你依然可以覆盖通过 di 容器设置的值:
echo \yii\widgets\linkpager::widget(['maxbuttoncount' => 20]);
另一个例子是借用 di 容器中自动构造方法注入带来的好处。假设你的控制器类依赖一些其他对象,例如一个旅馆预订服务。你可以通过一个构造器参数声明依赖关系,然后让 di 容器帮你自动解决这个依赖关系。
namespace app\controllers; use yii\web\controller; use app\components\bookinginterface; class hotelcontroller extends controller { protected $bookingservice; public function __construct($id, $module, bookinginterface $bookingservice, $config = []) { $this->bookingservice = $bookingservice; parent::__construct($id, $module, $config); } }
如果你从浏览器中访问这个控制器,你将看到一个报错信息,提醒你 bookinginterface 无法被实例化。这是因为你需要告诉 di 容器怎样处理这个依赖关系。
\yii::$container->set('app\components\bookinginterface', 'app\components\bookingservice');
现在如果你再次访问这个控制器,一个 app\components\bookingservice 的实例就会被创建并被作为第三个参数注入到控制器的构造器中。
什么时候注册依赖关系
由于依赖关系在创建新对象时需要解决,因此它们的注册应该尽早完成。如下是推荐的实践:
如果你是一个应用程序的开发者,你可以在应用程序的入口脚本或者被入口脚本引入的脚本中注册依赖关系。
如果你是一个可再分发扩展的开发者,你可以将依赖关系注册到扩展的引导类中。
总结
依赖注入和服务定位器都是流行的设计模式,它们使你可以用充分解耦且更利于测试的风格构建软件。强烈推荐你阅读 martin 的文章,对依赖注入和服务定位器有个更深入的理解。
yii 在依赖住入(di)容器之上实现了它的服务定位器。当一个服务定位器尝试创建一个新的对象实例时,它会把调用转发到 di 容器。后者将会像前文所述那样自动解决依赖关系。