概述
EventManger是一個為以下使用情況設計的組件:
復制代碼 代碼如下:
實現簡單的主題/觀察者模式
實現面向切面的設計
實現事件驅動的架構
基本的架構允許你添加和解除指定事件的偵聽器,無論是在一個實例基礎還是一個共享的集合;觸發事件;終止偵聽器的執行。
快速入門
通常,你將會在一個類中創建一個EventManager。
復制代碼 代碼如下:
use Zend\EventManager\EventManagerInterface;
use Zend\EventManager\EventManager;
use Zend\EventManager\EventManagerAwareInterface;
class Foo implements EventManagerAwareInterface
{
protected $events;
public function setEventManager(EventManagerInterface $events)
{
$events->setIdentifiers(array(
__CLASS__,
get_called_class(),
));
$this->events = $events;
return $this;
}
public function getEventManager()
{
if (null === $this->events) {
$this->setEventManager(new EventManager());
}
return $this->events;
}
}
上面的代碼允許用戶訪問EventManager實例,或使用一個新的實例重置它;如果不存在,它將會在被用到的時候惰性實例化。
EventManager僅僅對它是否觸發了一些事件感興趣。基礎的觸發接受三個參數:事件的名字,它通常是當前的函數/方法名;上下文,它通常是當前的對象的實例;和參數,它通常是提供給當前函數/方法的參數。
復制代碼 代碼如下:
class Foo
{
// ... assume events definition from above
public function bar($baz, $bat = null)
{
$params = compact('baz', 'bat');
$this->getEventManager()->trigger(__FUNCTION__, $this, $params);
}
}
按順序,觸發事件僅關心否有一些東西偵聽了事件。偵聽器添加到EventManager,指定一個指定的事件和要通知的回調。回調接受一個Event對象,它有一個用於獲取事件名字,上下文和參數的訪問器。讓我們添加一個偵聽器,並且觸發事件。
復制代碼 代碼如下:
use Zend\Log\Factory as LogFactory;
$log = LogFactory($someConfig);
$foo = new Foo();
$foo->getEventManager()->attach('bar', function ($e) use ($log) {
$event = $e->getName();
$target = get_class($e->getTarget());
$params = json_encode($e->getParams());
$log->info(sprintf(
'%s called on %s, using params %s',
$event,
$target,
$params
));
});
// Results in log message:
$foo->bar('baz', 'bat');
// reading: bar called on Foo, using params {"baz" : "baz", "bat" : "bat"}"
注意,attach()的第二個參數是一個任何有效的回調;例子中展示了一個匿名函數來保持例子是自包含的。然而,你同樣可以使用一個有效的函數名字,一個函數對象,一個引用靜態方法的字符串,或一個帶有一個指定靜態方法或實例方法的回調數組。再一次,任何PHP回調都是有效的。
有時候你可能想要指定一個偵聽器沒有一個創建了一個EventManager的類的對象實例。Zend Framework通過一個SharedEventCollection的概念來實現它。簡單的說,你可以使用一個眾所周知的SharedEventCollection來注入一個獨立的EventManager實例,並且EventManager實例將會為附加的偵聽器來查詢它。添加到SharedEventCollection的偵聽器與正常的事件管理器大略相同;調用attach與EventManager完全相同,但是在開始需要一個附加的參數:一個指定的實例。還記得創建一個EventManager的實例,我們是如何傳遞給他__CLASS__的?在使用一個SharedEventCollection時,那個值,或者任何你提供給構造器的數組中的任何字符串,可能用於識別一個實例。作為一個示例,假設我們有一個SharedEventManager實例我們知道已經被注入到我們的EventManager實例中了(對於實例,通過依賴注入),我們可以更改上面的例子來通過共享集合來添加:
復制代碼 代碼如下:
use Zend\Log\Factory as LogFactory;
// Assume $events is a Zend\EventManager\SharedEventManager instance
$log = LogFactory($someConfig);
$events->attach('Foo', 'bar', function ($e) use ($log) {
$event = $e->getName();
$target = get_class($e->getTarget());
$params = json_encode($e->getParams());
$log->info(sprintf(
'%s called on %s, using params %s',
$event,
$target,
$params
));
});
// Later, instantiate Foo:
$foo = new Foo();
$foo->getEventManager()->setSharedEventCollection($events);
// And we can still trigger the above event:
$foo->bar('baz', 'bat');
// results in log message:
// bar called on Foo, using params {"baz" : "baz", "bat" : "bat"}"
注意:StaticEventManager
在2.0.0beta3中,你可以使用StaticEventManager單例作為一個SharedEventCollection。這樣,你不需要擔心在哪或者如何來訪問SharedEventCollection;它通過簡單的調用StaticEventManager::getInstance()是全局可用的。
要知道,然而,框架不贊成它的使用,並且在2.0.0beta4中,你將通過配置一個SharedEventManager實例並注入到一個單獨的EventManager實例中來代替它。
通配符偵聽器
有時候你可能會想要為一個給定的實例的很多事件或全部事件添加相同的偵聽器,或者可能,使用一個共享事件集合,很多上下文,並且很多事件。EventManager組件允許這樣做。
一次添加多個事件
復制代碼 代碼如下:
$events = new EventManager();
$events->attach(array('these', 'are', 'event', 'names'), $callback);
通過通配符添加
復制代碼 代碼如下:
$events = new EventManager();
$events->attach('*', $callback);
注意如果你指定了一個優先級,那個優先級將會用於這個偵聽器觸發的任何事件。
上面的代碼指定的是任何時間觸發將會導致這個特定偵聽器的通知。
通過一個SharedEventManager一次添加多個事件
復制代碼 代碼如下:
$events = new SharedEventManager();
// Attach to many events on the context "foo"
$events->attach('foo', array('these', 'are', 'event', 'names'), $callback);
// Attach to many events on the contexts "foo" and "bar"
$events->attach(array('foo', 'bar'), array('these', 'are', 'event', 'names'), $callback);
注意如果你指定了一個優先級,那個優先級將會被用於所有指定的事件。
通過一個SharedEventManager一次添加所有事件
復制代碼 代碼如下:
$events = new SharedEventManager();
// Attach to all events on the context "foo"
$events->attach('foo', '*', $callback);
// Attach to all events on the contexts "foo" and "bar"
$events->attach(array('foo', 'bar'), '*', $callback);
注意如果你指定了一個優先級,那個優先級將會被用於所有指定的事件。
上面的代碼指定了上下文“foo”和“bar”,指定的偵聽器將會在任何事件觸發時被通知。
配置選項
EventManager選項
標識符
給定的EventManager實例可以回答的字符串或字符串數組,當通過一個SharedEventManager訪問時。
event_class
一個替代的Event類的名字用於代表傳給偵聽器的事件。
shared_collections
當觸發事件時的一個SharedEventCollection實例。
可用方法
__construct
__construct(null|string|int Sidentifier)
構造一個新的EventManager實例,使用給定的標識符,如果提供了的話,為了共享集合的目的。
setEventClass
setEventClass(string $class)
提供替換Event類的名字用在創建傳遞給觸發的偵聽器的事件時。
setSharedCollections
setSharedCollections(SharedEventCollection $collections=null)
用於觸發事件時的SharedEventCollection實例。
getSharedCollections
getSharedCollections()
返回當前添加到的SharedEventCollection實例。如果沒有添加集合,返回空,或者一個SharedEventCollection實例。
trigger
trigger(string $event, mixed $target, mixed $argv, callback $callback)
觸發指定事件的所有偵聽器。推薦為$event使用當前的函數/方法名,在後面加上諸如“.pre”、“.post”等,如果有需要的話。$context應該是當前對象的實例,或者是函數的名字如果不是使用對象觸發。$params通常應該是一個關聯數組或者ArrayAccess實例;我們推薦使用傳遞給函數/方法的參數(compact()在這裡通常很有用處)。這個方法同樣可以接受一個回調並且表現與triggerUntil()相同。
方法返回一個ResponseCollection的實例,它可以用於反省各種各樣的偵聽器返回的值,測試短路,以及更多。
triggerUntil
triggerUntil(string $event, mixed $context, mixed $argv, callback $callback)
觸發指定事件的所有偵聽器,就像trigger(),額外的是它將每個偵聽器的返回值傳遞給$callback;如果$callback返回一個布爾true值,偵聽器的執行將被終止。你可以使用$result->stopped()來測試它。
attach
attach(string $event, callback $callback, int $priority)
添加$callback到EventManager實例,偵聽事件$event。如果提供了一個$priority,偵聽器將會使用那個優先級插入到內部的偵聽器堆棧;高的值會先執行。(默認的優先級是“1”,並且運行使用負的值。)
方法返回一個Zend\Stdlib\CallbackHandler的實例;這個值可以在稍後傳遞給detach(),如果需要的話。
attachAggregate
attachAggregate(string|ListenerAggregate $aggregate)
如果一個字符串被傳遞作為$aggregate,實例化那個類。$aggregate然後被傳遞給EventManager實例的attache()方法因此他可以注冊偵聽器。
返回ListenerAggregate實例。
detach
detach(CallbackHandler $listener)
掃描所有的偵聽器,並且取消匹配$listener的所有偵聽器因此它們將不再會被觸發。
返回一個true布爾值如果任何偵聽器已經被指定並且取消訂閱,否則返回一個false布爾值。
detachAggregate
detachAggregate(ListenerAggregate $aggregate)
循環所有的事件來確定集合代表的偵聽器;對於所有的匹配項,偵聽器將會被移除。
如果任何偵聽器被確定並被取消訂閱返回一個true布爾值,否則返回一個false布爾值。
getEvents
getEvent()
返回一個有偵聽器附加的所有事件名字的數組。
getListeners
getListeners(string $event)
返回一個添加到$event的所有偵聽器的Zend\Stdlib\PriorityQueue實例
clearListeners
clearListeners(string $event)
移除添加到$event的所有偵聽器。
prepareArgs
prepareArgs(array $args)
從提供的$args創建一個ArrayObject。如果你想要你的偵聽器可以更改參數讓稍後的偵聽器或觸發的方法可以看到這些更改的情況下著將很有用。
借你的寶地跟一個回答,zend framework 2 交流學習,來這裡吧,人稍微多點。群號213966183
知道就好