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)