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

2020-03-22 20:27:06

字體：大中小

供稿：網(wǎng)友

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

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

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

下一篇：ThinkPHP5快速入門方法的介紹