深入解析PHP的Yii架構中的event事件機制，yiievent_PHP教程

深入解析PHP的Yii架構中的event事件機制，yiievent

事件
事件可以將自訂代碼“注入”到現有代碼中的特定執行點。附加自訂代碼到某個事件，當這個事件被觸發時，這些代碼就會自動執行。例如，郵件程式對象成功發出訊息時可觸發 messageSent 事件。如想追蹤成功發送的訊息，可以附加相應追蹤代碼到messageSent 事件。
Yii 引入了名為 yii\base\Component 的基類以支援事件。如果一個類需要觸發事件就應該繼承 yii\base\Component 或其子類。

Yii的event機制
YII的事件機制，是其比較獨特之處，合理使用好事件機制，會使各個組件之間的耦合更為鬆散，利於團體協作開發。
何時需要使用事件，如何給事件綁定事件處理函數，以及如何觸發事件，與其它語言是有較大的差別的。例如Javascript中，可以使用

$(‘#id').on("click",function() {});

方式給DOM元素繫結處理函數，當DOM元素上發生指定的事件（如click）時，將自動執行設定的函數。
但是PHP是伺服器端的指令碼語言，就不存在自動觸發事件之說，所以和Javascript對比，YII中的事件是需要手動觸發的。一般來說，要實現YII組件的事件機制，需要以下幾步：

定義事件名稱，其實就是級組件定義一個on開頭的方法，其中的代碼是固定的，如：

 public function onBeginRequest($event){ $this->raiseEvent('onBeginRequest',$event);}

即函數名與事件名是一致的。此步的作用就是將綁定在此事件上的處理函數逐個執行。寫這一系列的播客，算是一個整理，所以我寫細一點，現在把raiseEvent方法的代碼貼出來。

/** * Raises an event.   * This method represents the happening of an event. It invokes   * all attached handlers for the event.   * @param string $name the event name   * @param CEvent $event the event parameter   * @throws CException if the event is undefined or an event handler is invalid. */  public function raiseEvent($name,$event){         $name=strtolower($name);         //_e這個數組用來存所有事件資訊       if(isset($this->_e[$name]))  {             foreach($this->_e[$name] as $handler) {                 if(is_string($handler))               call_user_func($handler,$event);                   elseif(is_callable($handler,true)){                  if(is_array($handler)){                           // an array: 0 - object, 1 - method name                     list($object,$method)=$handler;                      if(is_string($object)) // static method call                     call_user_func($handler,$event);                    elseif(method_exists($object,$method))                          $object->$method($event);                           else                              throw new CException(Yii::t('yii','Event "{class}.{event}" is attached with an invalid handler "{handler}".',  array('{class}'=>get_class($this), '{event}'=>$name, '{handler}'=>$handler[1])));                        }                        else // PHP 5.3: anonymous function                      call_user_func($handler,$event);                 }                 else                    throw new CException(Yii::t('yii','Event "{class}.{event}" is attached with an invalid handler "{handler}".', array('{class}'=>get_class($this), '{event}'=>$name, '{handler}'=>gettype($handler))));                // stop further handling if param.handled is set true             if(($event instanceof CEvent) && $event->handled)               return;             }         }  elseif(YII_DEBUG && !$this->hasEvent($name))             throw new CException(Yii::t('yii','Event "{class}.{event}" is not defined.',     array('{class}'=>get_class($this), '{event}'=>$name))); }

事件處理器（Event Handlers）

事件處理器是一個PHP 回呼函數，當它所附加到的事件被觸發時它就會執行。可以使用以下回呼函數之一：

• 字串形式指定的 PHP 全域函數，如 'trim' ；
• 對象名和方法名數組形式指定的對象方法，如 [$object, $method] ；
• 類名和方法名數組形式指定的靜態類方法，如 [$class, $method] ；
• 匿名函數，如 function ($event) { ... } 。

事件處理器的格式是：

function ($event) {  // $event 是 yii\base\Event 或其子類的對象}

通過 $event 參數，事件處理器就獲得了以下有關事件的資訊：

• yii\base\Event::name：事件名
• yii\base\Event::sender：調用 trigger() 方法的對象
• yii\base\Event::data：附加事件處理器時傳入的資料，預設為空白，後文詳述

附加事件處理器

調用 yii\base\Component::on() 方法來附加處理器到事件上。如：

$foo = new Foo;// 處理器是全域函數$foo->on(Foo::EVENT_HELLO, 'function_name');// 處理器是對象方法$foo->on(Foo::EVENT_HELLO, [$object, 'methodName']);// 處理器是靜態類方法$foo->on(Foo::EVENT_HELLO, ['app\components\Bar', 'methodName']);// 處理器是匿名函數$foo->on(Foo::EVENT_HELLO, function ($event) {  //事件處理邏輯});附加事件處理器時可以提供額外資料作為 yii\base\Component::on() 方法的第三個參數。資料在事件被觸發和處理器被調用時能被處理器使用。如：// 當事件被觸發時以下代碼顯示 "abc"// 因為 $event->data 包括被傳遞到 "on" 方法的資料$foo->on(Foo::EVENT_HELLO, function ($event) {  echo $event->data;}, 'abc');

事件處理器順序

可以附加一個或多個處理器到一個事件。當事件被觸發，已附加的處理器將按附加次序依次調用。如果某個處理器需要停止其後的處理器調用，可以設定 $event 參數的 [yii\base\Event::handled]] 屬性為真，如下：

$foo->on(Foo::EVENT_HELLO, function ($event) {  $event->handled = true;});

預設新附加的事件處理器排在已存在處理器隊列的最後。因此，這個處理器將在事件被觸發時最後一個調用。在處理器隊列最前面插入新處理器將使該處理器最先調用，可以傳遞第四個參數 $append 為假並調用 yii\base\Component::on() 方法實現：

$foo->on(Foo::EVENT_HELLO, function ($event) {  // 這個處理器將被插入到處理器隊列的第一位...}, $data, false);

觸發事件

事件通過調用 yii\base\Component::trigger() 方法觸發，此方法須傳遞事件名，還可以傳遞一個事件對象，用來傳遞參數到事件處理器。如：

namespace app\components;use yii\base\Component;use yii\base\Event;class Foo extends Component{  const EVENT_HELLO = 'hello';  public function bar()  {    $this->trigger(self::EVENT_HELLO);  }}

以上代碼當調用 bar() ，它將觸發名為 hello 的事件。

提示：推薦使用類常量來表示事件名。上例中，常量 EVENT_HELLO 用來表示 hello 。這有兩個好處。第一，它可以防止拼字錯誤並支援 IDE 的自動完成。第二，只要簡單檢查常量聲明就能瞭解一個類支援哪些事件。
有時想要在觸發事件時同時傳遞一些額外資訊到事件處理器。例如，郵件程式要傳遞訊息資訊到 messageSent 事件的處理器以便處理器瞭解哪些訊息被發送了。為此，可以提供一個事件對象作為 yii\base\Component::trigger() 方法的第二個參數。這個事件對象必須是 yii\base\Event 類或其子類的執行個體。如：

namespace app\components;use yii\base\Component;use yii\base\Event;class MessageEvent extends Event{  public $message;}class Mailer extends Component{  const EVENT_MESSAGE_SENT = 'messageSent';  public function send($message)  {    // ...發送 $message 的邏輯...    $event = new MessageEvent;    $event->message = $message;    $this->trigger(self::EVENT_MESSAGE_SENT, $event);  }}

當 yii\base\Component::trigger() 方法被調用時，它將調用所有附加到命名事件（trigger 方法第一個參數）的事件處理器。

移除事件處理器

從事件移除處理器，調用 yii\base\Component::off() 方法。如：

// 處理器是全域函數$foo->off(Foo::EVENT_HELLO, 'function_name');// 處理器是對象方法$foo->off(Foo::EVENT_HELLO, [$object, 'methodName']);// 處理器是靜態類方法$foo->off(Foo::EVENT_HELLO, ['app\components\Bar', 'methodName']);// 處理器是匿名函數$foo->off(Foo::EVENT_HELLO, $anonymousFunction);

注意當匿名函數附加到事件後一般不要嘗試移除匿名函數，除非你在某處儲存了它。以上樣本中，假設匿名函數儲存為變數$anonymousFunction 。

移除事件的全部處理器，簡單調用 yii\base\Component::off() 即可，不需要第二個參數：

$foo->off(Foo::EVENT_HELLO);

類層級的事件處理器

以上部分，我們敘述了在執行個體層級如何附加處理器到事件。有時想要一個類的所有執行個體而不是一個指定的執行個體都響應一個被觸發的事件，並不是一個個附加事件處理器到每個執行個體，而是通過調用靜態方法 yii\base\Event::on() 在類層級附加處理器。

例如，活動記錄對象要在每次往資料庫新增一條新記錄時觸發一個 yii\db\BaseActiveRecord::EVENT_AFTER_INSERT 事件。要追蹤每個活動記錄對象的新增記錄完成情況，應如下寫代碼：

use Yii;use yii\base\Event;use yii\db\ActiveRecord;Event::on(ActiveRecord::className(), ActiveRecord::EVENT_AFTER_INSERT, function ($event) {  Yii::trace(get_class($event->sender) . ' is inserted');});

每當 yii\db\BaseActiveRecord 或其子類的執行個體觸發 yii\db\BaseActiveRecord::EVENT_AFTER_INSERT 事件時，這個事件處理器都會執行。在這個處理器中，可以通過 $event->sender 擷取觸發事件的對象。

當對象觸發事件時，它首先調用執行個體層級的處理器，然後才會調用類層級處理器。

可調用靜態方法yii\base\Event::trigger()來觸發一個類層級事件。類層級事件不與特定對象相關聯。因此，它只會引起類層級事件處理器的調用。如：

use yii\base\Event;Event::on(Foo::className(), Foo::EVENT_HELLO, function ($event) {  echo $event->sender; // 顯示 "app\models\Foo"});Event::trigger(Foo::className(), Foo::EVENT_HELLO);

注意這種情況下 $event->sender 指向觸發事件的類名而不是對象執行個體。

注意：因為類層級的處理器響應類和其子類的所有執行個體觸發的事件，必須謹慎使用，尤其是底層的基類，如 yii\base\Object。
移除類層級的事件處理器只需調用yii\base\Event::off()，如：

// 移除 $handlerEvent::off(Foo::className(), Foo::EVENT_HELLO, $handler);// 移除 Foo::EVENT_HELLO 事件的全部處理器Event::off(Foo::className(), Foo::EVENT_HELLO);

全域事件

所謂全域事件實際上是一個基於以上敘述的事件機制的戲法。它需要一個全域可訪問的單例，如應用執行個體。

事件觸發者不調用其自身的 trigger() 方法，而是調用單例的 trigger() 方法來觸發全域事件。類似地，事件處理器被附加到單例的事件。如：

use Yii;use yii\base\Event;use app\components\Foo;Yii::$app->on('bar', function ($event) {  echo get_class($event->sender); // 顯示 "app\components\Foo"});Yii::$app->trigger('bar', new Event(['sender' => new Foo]));

全域事件的一個好處是當附加處理器到一個對象要觸發的事件時，不需要產生該對象。相反，處理器附加和事件觸發都通過單例（如應用執行個體）完成。

然而，因為全域事件的命名空間由各方共用，應合理命名全域事件，如引入一些命名空間（例："frontend.mail.sent", "backend.mail.sent"）。

給組件對象綁定事件處理函數

$component->attachEventHandler($name, $handler);$component->onBeginRequest = $handler ;

yii支援一個事件綁定多個回呼函數，上述的兩個方法都會在已有的事件上增加新的回呼函數，而不會覆蓋已有回呼函數。
$handler即是一個PHP回呼函數，關於回呼函數的形式，本文的最後會附帶說明。如CLogRouter組件的init事件中，有以下代碼：

Yii::app()->attachEventHandler('onEndRequest',array($this,'processLogs'));

這就是給CApplication對象的onEndRequest綁定了CLogRouter::processLogs()回呼函數。而CApplication組件確實存在名為onEndRequest的方法（即onEndRequest事件）,它之中的代碼就是啟用了相應的回呼函數，即CLogRouter::processLogs()方法。所以從這裡可以得出，日誌的記錄其實是發生在CApplication組件的正常退出時。

在需要觸發事件的時候，直接啟用組件的事件，即呼叫事件即可，如：比如CApplication組件的run方法中：

if($this->hasEventHandler('onBeginRequest'))  $this->onBeginRequest(new CEvent($this));

這樣即觸發了事件處理函數。如果沒有第一行的判斷，那麼在偵錯模式下（YII_DEBUG常量被定義為true），會拋出異常，而在非偵錯模式下（YII_DEBUG常量定義為false或沒有定義YII_DEBUG常量），則不會產生任何異常。
回呼函數的形式：

普通全域函數（內建的或使用者自訂的）

call_user_func(‘print', $str);

類的靜態方法，使用數組形式傳遞

call_user_func(array(‘className', ‘print'), $str );

對象方法，使用數組形式傳遞

$obj = new className();call_user_func(array($obj, ‘print'), $str );

匿名方法，類似javascript的匿名函數

call_user_func(function($i){echo $i++;},4);

或使用以下形式：

$s = function($i) {  echo $i++;};call_user_func($s,4);

總結

關於Yii的事件機制其實就是提供了一種用於解耦的方式，在需要調用event的地方之前，只要你提供了事件的實現並註冊在之後的地方需要的時候即可調用。

您可能感興趣的文章:

• PHP的Yii架構中移除組件所綁定的行為的方法
• PHP的Yii架構中行為的定義與Binder 方法講解
• 詳解在PHP的Yii架構中使用行為Behaviors的方法
• 深入講解PHP的Yii架構中的屬性（Property）
• PHP的Yii架構中使用資料庫的配置和SQL操作執行個體教程
• 全面解讀PHP的Yii架構中的日誌功能
• Yii使用find findAll尋找出指定欄位的實現方法
• 解析yii資料庫的增刪查改
• Yii PHP Framework實用入門教程(詳細介紹)
• 詳解PHP的Yii架構中組件行為的屬性注入和方法注入

http://www.bkjia.com/PHPjc/1111325.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/1111325.htmlTechArticle深入解析PHP的Yii架構中的event事件機制，yiievent 事件 事件可以將自訂代碼“注入”到現有代碼中的特定執行點。附加自訂代碼到某個事...

