Zend Framework 2.0事件管理器（The EventManager）入门教程(3)

时间:2014-08-13 02:42来源:网络整理作者:网络点击: 次

分享到：

通过一个SharedEventManager一次添加所有事件复制代码代码如下: $events = new SharedEventManager(); // Attach to all events on the context "foo" $events-attach('foo', '*', $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实例。