詳解PHP的Yii框架中組件行為的屬性注入和方法注

2020-03-22 20:27:06

字體：大中小

供稿：網(wǎng)友

行為的屬性和方法注入原理上面我們了解到了行為的用意在于將自身的屬性和方法注入給所依附的類(lèi)。那么Yii中是如何將一個(gè)行為 yii/base/Behavior 的屬性和方法，注入到一個(gè) yii/base/Component 中的呢？對(duì)于屬性而言，是通過(guò) __get() 和 __set() 魔術(shù)方法來(lái)實(shí)現(xiàn)的。對(duì)于方法，是通過(guò) __call() 方法。屬性的注入以讀取為例，如果訪(fǎng)問(wèn) $Component- property1 ，Yii在幕后干了些什么呢？這個(gè)看看 yii/base/Component::__get()html' target='_blank'>public function __get($name) $getter = 'get' . $name; if (method_exists($this, $getter)) { return $this- $getter(); } else { // 注意這個(gè) else 分支的內(nèi)容，正是與 yii/base/Object::__get() 的 // 不同之處 $this- ensureBehaviors(); foreach ($this- _behaviors as $behavior) { if ($behavior- canGetProperty($name)) { // 屬性在行為中須為 public。否則不可能通過(guò)下面的形式訪(fǎng)問(wèn)呀。 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);重點(diǎn)來(lái)看 yii/base/Compoent::__get() 與 yii/base/Object::__get() 的不同之處。就是在于對(duì)于未定義getter函數(shù)之后的處理， yii/base/Object 是直接拋出異常，告訴你想要訪(fǎng)問(wèn)的屬性不存在之類(lèi)。但是 yii/base/Component 則是在不存在getter之后，還要看看是不是注入的行為的屬性：首先，調(diào)用了 $this- ensureBehaviors() 。這個(gè)方法已經(jīng)在前面講過(guò)了，主要是確保行為已經(jīng)綁定。
在確保行為已經(jīng)綁定后，開(kāi)始遍歷 $this- _behaviors 。 Yii將類(lèi)所有綁定的行為都保存在 yii/base/Compoent::$_behaviors[] 數(shù)組中。
最后，通過(guò)行為的 canGetProperty() 判斷這個(gè)屬性，是否是所綁定行為的可讀屬性，如果是，就返回這個(gè)行為的這個(gè)屬性 $behavior- name 。完成屬性的讀取。至于 canGetProperty() 已經(jīng)在 :ref::property 部分已經(jīng)簡(jiǎn)單講過(guò)了，后面還會(huì)有針對(duì)性地一個(gè)介紹。
對(duì)于setter，代碼類(lèi)似，這里就不占用篇幅了。方法的注入與屬性的注入通過(guò) __get() __set() 魔術(shù)方法類(lèi)似， Yii通過(guò) __call() 魔術(shù)方法實(shí)現(xiàn)對(duì)行為中方法的注入: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還是先是調(diào)用了 $this- ensureBehaviors() 確保行為已經(jīng)綁定。然后，也是遍歷 yii/base/Component::$_behaviros[] 數(shù)組。通過(guò) hasMethod() 方法判斷方法是否存在。如果所綁定的行為中要調(diào)用的方法存在，則使用PHP的 call_user_func_array() 調(diào)用之。至于 hasMethod() 方法，我們后面再講。注入屬性與方法的訪(fǎng)問(wèn)控制在前面我們針對(duì)行為中public和private、protected的成員在所綁定的類(lèi)中是否可訪(fǎng)問(wèn)舉出了具體例子。這里我們從代碼層面解析原因。在上面的內(nèi)容，我們知道，一個(gè)屬性可不可訪(fǎng)問(wèn)，主要看行為的 canGetProperty() 和 canSetProperty() 。而一個(gè)方法可不可調(diào)用，主要看行為的 hasMethod() 。由于 yii/base/Behavior 繼承自我們的老朋友 yii/base/Object ，所以上面提到的三個(gè)判斷方法，事實(shí)上代碼都在 Object 中。我們一個(gè)一個(gè)來(lái)看: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);這三個(gè)方法真的談不上復(fù)雜。對(duì)此，我們可以得出以下結(jié)論：當(dāng)向Component綁定的行為讀?。▽?xiě)入）一個(gè)屬性時(shí)，如果行為為該屬性定義了一個(gè)getter (setter)，則可以訪(fǎng)問(wèn)。或者，如果行為確實(shí)具有該成員變量即可通過(guò)上面的判斷，此時(shí)，該成員變量可為 public, private, protected。但最終只有 public 的成員變量才能正確訪(fǎng)問(wèn)。原因在上面講注入的原理時(shí)已經(jīng)交待了。
當(dāng)調(diào)用Component綁定的行為的一個(gè)方法時(shí)，如果行為已經(jīng)定義了該方法，即可通過(guò)上面的判斷。此時(shí)，這個(gè)方法可以為 public, private, protected。但最終只有 public 的方法才能正確調(diào)用。如果你理解了上一款的原因，那么這里也就理解了。
依賴(lài)注入容器
依賴(lài)注入（Dependency Injection，DI）容器就是一個(gè)對(duì)象，它知道怎樣初始化并配置對(duì)象及其依賴(lài)的所有對(duì)象。Martin 的文章已經(jīng)解釋了 DI 容器為什么很有用。這里我們主要講解 Yii 提供的 DI 容器的使用方法。依賴(lài)注入Yii 通過(guò) yii/di/Container 類(lèi)提供 DI 容器特性。它支持如下幾種類(lèi)型的依賴(lài)注入：構(gòu)造方法注入; Setter 和屬性注入; PHP 回調(diào)注入. 構(gòu)造方法注入在參數(shù)類(lèi)型提示的幫助下，DI 容器實(shí)現(xiàn)了構(gòu)造方法注入。當(dāng)容器被用于創(chuàng)建一個(gè)新對(duì)象時(shí)，類(lèi)型提示會(huì)告訴它要依賴(lài)什么類(lèi)或接口。容器會(huì)嘗試獲取它所依賴(lài)的類(lèi)或接口的實(shí)例，然后通過(guò)構(gòu)造器將其注入新的對(duì)象。例如：class Foo public function __construct(Bar $bar)$foo = $container- get('Foo');// 上面的代碼等價(jià)于：$bar = new Bar;$foo = new Foo($bar);Setter 和屬性注入Setter 和屬性注入是通過(guò)配置提供支持的。當(dāng)注冊(cè)一個(gè)依賴(lài)或創(chuàng)建一個(gè)新對(duì)象時(shí)，你可以提供一個(gè)配置，該配置會(huì)提供給容器用于通過(guò)相應(yīng)的 Setter 或?qū)傩宰⑷胍蕾?lài)。例如：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 回調(diào)注入這種情況下，容器將使用一個(gè)注冊(cè)過(guò)的 PHP 回調(diào)創(chuàng)建一個(gè)類(lèi)的新實(shí)例?；卣{(diào)負(fù)責(zé)解決依賴(lài)并將其恰當(dāng)?shù)刈⑷胄聞?chuàng)建的對(duì)象。例如：$container- set('Foo', function () { return new Foo(new Bar);$foo = $container- get('Foo');注冊(cè)依賴(lài)關(guān)系可以用 yii/di/Container::set() 注冊(cè)依賴(lài)關(guān)系。注冊(cè)會(huì)用到一個(gè)依賴(lài)關(guān)系名稱(chēng)和一個(gè)依賴(lài)關(guān)系的定義。依賴(lài)關(guān)系名稱(chēng)可以是一個(gè)類(lèi)名，一個(gè)接口名或一個(gè)別名。依賴(lài)關(guān)系的定義可以是一個(gè)類(lèi)名，一個(gè)配置數(shù)組，或者一個(gè) PHP 回調(diào)。$container = new /yii/di/Container;// 注冊(cè)一個(gè)同類(lèi)名一樣的依賴(lài)關(guān)系，這個(gè)可以省略。$container- set('yii/db/Connection');// 注冊(cè)一個(gè)接口// 當(dāng)一個(gè)類(lèi)依賴(lài)這個(gè)接口時(shí)，相應(yīng)的類(lèi)會(huì)被初始化作為依賴(lài)對(duì)象。$container- set('yii/mail/MailInterface', 'yii/swiftmailer/Mailer');// 注冊(cè)一個(gè)別名。// 你可以使用 $container- get('foo') 創(chuàng)建一個(gè) Connection 實(shí)例$container- set('foo', 'yii/db/Connection');// 通過(guò)配置注冊(cè)一個(gè)類(lèi)// 通過(guò) get() 初始化時(shí)，配置將會(huì)被使用。$container- set('yii/db/Connection', [ 'dsn' = 'mysql:host=127.0.0.1;dbname=demo', 'username' = 'root', 'password' = '', 'charset' = 'utf8',// 通過(guò)類(lèi)的配置注冊(cè)一個(gè)別名// 這種情況下，需要通過(guò)一個(gè) “class” 元素指定這個(gè)類(lèi)$container- set('db', [ 'class' = 'yii/db/Connection', 'dsn' = 'mysql:host=127.0.0.1;dbname=demo', 'username' = 'root', 'password' = '', 'charset' = 'utf8',// 注冊(cè)一個(gè) PHP 回調(diào)// 每次調(diào)用 $container- get('db') 時(shí)，回調(diào)函數(shù)都會(huì)被執(zhí)行。$container- set('db', function ($container, $params, $config) { return new /yii/db/Connection($config);// 注冊(cè)一個(gè)組件實(shí)例// $container- get('pageCache') 每次被調(diào)用時(shí)都會(huì)返回同一個(gè)實(shí)例。$container- set('pageCache', new FileCache);Tip: 如果依賴(lài)關(guān)系名稱(chēng)和依賴(lài)關(guān)系的定義相同，則不需要通過(guò) DI 容器注冊(cè)該依賴(lài)關(guān)系。
通過(guò) set() 注冊(cè)的依賴(lài)關(guān)系，在每次使用時(shí)都會(huì)產(chǎn)生一個(gè)新實(shí)例?？梢允褂?yii/di/Container::setSingleton() 注冊(cè)一個(gè)單例的依賴(lài)關(guān)系：$container- setSingleton('yii/db/Connection', [ 'dsn' = 'mysql:host=127.0.0.1;dbname=demo', 'username' = 'root', 'password' = '', 'charset' = 'utf8',解決依賴(lài)關(guān)系注冊(cè)依賴(lài)關(guān)系后，就可以使用 DI 容器創(chuàng)建新對(duì)象了。容器會(huì)自動(dòng)解決依賴(lài)關(guān)系，將依賴(lài)實(shí)例化并注入新創(chuàng)建的對(duì)象。依賴(lài)關(guān)系的解決是遞歸的，如果一個(gè)依賴(lài)關(guān)系中還有其他依賴(lài)關(guān)系，則這些依賴(lài)關(guān)系都會(huì)被自動(dòng)解決。可以使用 yii/di/Container::get() 創(chuàng)建新的對(duì)象。該方法接收一個(gè)依賴(lài)關(guān)系名稱(chēng)，它可以是一個(gè)類(lèi)名，一個(gè)接口名或一個(gè)別名。依賴(lài)關(guān)系名或許是通過(guò) set() 或 setSingleton() 注冊(cè)的。你可以隨意地提供一個(gè)類(lèi)的構(gòu)造器參數(shù)列表和一個(gè)configuration 用于配置新創(chuàng)建的對(duì)象。例如：// "db" 是前面定義過(guò)的一個(gè)別名$db = $container- get('db');// 等價(jià)于： $engine = new /app/components/SearchEngine($apiKey, ['type' = 1]);$engine = $container- get('app/components/SearchEngine', [$apiKey], ['type' = 1]);代碼背后，DI 容器做了比創(chuàng)建對(duì)象多的多的工作。容器首先將檢查類(lèi)的構(gòu)造方法，找出依賴(lài)的類(lèi)或接口名，然后自動(dòng)遞歸解決這些依賴(lài)關(guān)系。如下代碼展示了一個(gè)更復(fù)雜的示例。UserLister 類(lèi)依賴(lài)一個(gè)實(shí)現(xiàn)了 UserFinderInterface 接口的對(duì)象；UserFinder 類(lèi)實(shí)現(xiàn)了這個(gè)接口，并依賴(lài)于一個(gè) Connection 對(duì)象。所有這些依賴(lài)關(guān)系都是通過(guò)類(lèi)構(gòu)造器參數(shù)的類(lèi)型提示定義的。通過(guò)屬性依賴(lài)關(guān)系的注冊(cè)，DI 容器可以自動(dòng)解決這些依賴(lài)關(guān)系并能通過(guò)一個(gè)簡(jiǎn)單的 get('userLister') 調(diào)用創(chuàng)建一個(gè)新的 UserLister 實(shí)例。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');// 等價(jià)于:$db = new /yii/db/Connection(['dsn' = '...']);$finder = new UserFinder($db);$lister = new UserLister($finder);實(shí)踐中的運(yùn)用當(dāng)在應(yīng)用程序的入口腳本中引入 Yii.php 文件時(shí)，Yii 就創(chuàng)建了一個(gè) DI 容器。這個(gè) DI 容器可以通過(guò) Yii::$container 訪(fǎng)問(wèn)。當(dāng)調(diào)用 Yii::createObject() 時(shí)，此方法實(shí)際上會(huì)調(diào)用這個(gè)容器的 yii/di/Container::get() 方法創(chuàng)建新對(duì)象。如上所述，DI 容器會(huì)自動(dòng)解決依賴(lài)關(guān)系（如果有）并將其注入新創(chuàng)建的對(duì)象中。因?yàn)?Yii 在其多數(shù)核心代碼中都使用了 Yii::createObject() 創(chuàng)建新對(duì)象，所以你可以通過(guò) Yii::$container 全局性地自定義這些對(duì)象。例如，你可以全局性自定義 yii/widgets/LinkPager 中分頁(yè)按鈕的默認(rèn)數(shù)量:/Yii::$container- set('yii/widgets/LinkPager', ['maxButtonCount' = 5]);這樣如果你通過(guò)如下代碼在一個(gè)視圖里使用這個(gè)掛件，它的 maxButtonCount 屬性就會(huì)被初始化為 5 而不是類(lèi)中定義的默認(rèn)值 10。echo /yii/widgets/LinkPager::widget();然而你依然可以覆蓋通過(guò) DI 容器設(shè)置的值：echo /yii/widgets/LinkPager::widget(['maxButtonCount' = 20]);另一個(gè)例子是借用 DI 容器中自動(dòng)構(gòu)造方法注入帶來(lái)的好處。假設(shè)你的控制器類(lèi)依賴(lài)一些其他對(duì)象，例如一個(gè)旅館預(yù)訂服務(wù)。你可以通過(guò)一個(gè)構(gòu)造器參數(shù)聲明依賴(lài)關(guān)系，然后讓 DI 容器幫你自動(dòng)解決這個(gè)依賴(lài)關(guān)系。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);如果你從瀏覽器中訪(fǎng)問(wèn)這個(gè)控制器，你將看到一個(gè)報(bào)錯(cuò)信息，提醒你 BookingInterface 無(wú)法被實(shí)例化。這是因?yàn)槟阈枰嬖V DI 容器怎樣處理這個(gè)依賴(lài)關(guān)系。/Yii::$container- set('app/components/BookingInterface', 'app/components/BookingService');
現(xiàn)在如果你再次訪(fǎng)問(wèn)這個(gè)控制器，一個(gè) app/components/BookingService 的實(shí)例就會(huì)被創(chuàng)建并被作為第三個(gè)參數(shù)注入到控制器的構(gòu)造器中。什么時(shí)候注冊(cè)依賴(lài)關(guān)系由于依賴(lài)關(guān)系在創(chuàng)建新對(duì)象時(shí)需要解決，因此它們的注冊(cè)應(yīng)該盡早完成。如下是推薦的實(shí)踐：如果你是一個(gè)應(yīng)用程序的開(kāi)發(fā)者，你可以在應(yīng)用程序的入口腳本或者被入口腳本引入的腳本中注冊(cè)依賴(lài)關(guān)系。
如果你是一個(gè)可再分發(fā)擴(kuò)展的開(kāi)發(fā)者，你可以將依賴(lài)關(guān)系注冊(cè)到擴(kuò)展的引導(dǎo)類(lèi)中。
總結(jié)依賴(lài)注入和服務(wù)定位器都是流行的設(shè)計(jì)模式，它們使你可以用充分解耦且更利于測(cè)試的風(fēng)格構(gòu)建軟件。強(qiáng)烈推薦你閱讀 Martin 的文章，對(duì)依賴(lài)注入和服務(wù)定位器有個(gè)更深入的理解。Yii 在依賴(lài)住入（DI）容器之上實(shí)現(xiàn)了它的服務(wù)定位器。當(dāng)一個(gè)服務(wù)定位器嘗試創(chuàng)建一個(gè)新的對(duì)象實(shí)例時(shí)，它會(huì)把調(diào)用轉(zhuǎn)發(fā)到 DI 容器。后者將會(huì)像前文所述那樣自動(dòng)解決依賴(lài)關(guān)系。PHP教程

鄭重聲明：本文版權(quán)歸原作者所有，轉(zhuǎn)載文章僅為傳播更多信息之目的，如作者信息標(biāo)記有誤，請(qǐng)第一時(shí)間聯(lián)系我們修改或刪除，多謝。

上一篇：php基于seoreport類(lèi)針對(duì)網(wǎng)站SEO信息檢查與獲取

下一篇：ThinkPHP5快速入門(mén) 方法的介紹