|
概述
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实例将会为附加的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。如果你想要你的侦听器可以更改参数让稍后的侦听器或触发的方法可以看到这些更改的情况下着将很有用。 | 
转播
