Download the PHP package guirong/php-event without Composer
On this page you can find all versions of the php package guirong/php-event. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download guirong/php-event
More information about guirong/php-event
Files in guirong/php-event
Package php-event
Short Description an simple event, listener library of the php
License MIT
Homepage https://github.com/GuiRong2969/php-event
Informations about the package php-event
PHP Validate
一个简洁小巧的php事件监听器。
- 事件系统主要负责应用解耦
- 单个事件可以拥有多个互不依赖的监听器
- 提供了一个简单的观察者实现
- 订阅模式下,事件订阅者是可以在自身内部订阅多个事件的类
- 事件注册
\Guirong\Event\listen($event,$listener)
,用于 快速注册事件监听 - 事件触发
\Guirong\Event\trigger($service,$event,$payload)
,用于 分发事件
使用助手函数
event()
项目地址
注意:
- 版本要求
php >= 5.5.0
安装
注册事件和监听器
应用中的 \Guirong\Event\Event
服务类为注册所有的事件监听器提供了一个便利的场所。其中, listen 属性包含了所有事件 (键) 以及事件对应的监听器 (值) 的数组。当然,你可以根据应用的需要,添加多个事件到 listen 属性包含的数组中。你可以直接使用此类作为服务提供者,也可以继承它(建议)。 举个例子,让我们来定义一个新的服务提供者,并来添加一个 OrderPayed 事件:
- 配置示例: (本文档的服务提供者定义为
\Guirong\Event\Event\EventService
)
定义事件
- 事件类是一个保存与事件相关信息的容器。例如,假设我们生成的 OrderPayed 事件接收一个数据集合:
定义监听器
- 事件监听器默认在 handle 方法中接收实例,在方法中你可以执行任何必要的响应事件的操作
NotifyBuyerListener
监听器:
NotifyShopListener
监听器:
分发事件
- 如果要分发事件,你可以将事件实例传递给函数
\Guirong\Event\trigger()
。该函数将会把事件分发到所有该事件相应的已经注册了的监听器上
助手函数 event()
EventService
服务类由Guirong\Event\Container
容器创建并接管,不会重复创建实例 假如你觉得事件分发时每次都要传入服务类不方便,可以自己定一个简单的助手函数,引入当前的项目中
事件订阅者
事件订阅者是可以在自身内部订阅多个事件处理器(事件类),订阅者定义的 subscribe
方法接收一个事件分发器实例。你可以调用对应事件分发器上的 listen
方法来注册事件监听器:
定义事件
UserRegister
事件:
UserDestory
事件:
注册事件订阅者
在编写完订阅者之后,就可以通过事件分发器对订阅者进行注册。你可以在 EventService 中的 $subscribe 属性中注册订阅者。例如,让我们将 UserEventSubscriber 添加到数组列表中:
分发事件
使用助手函数
event()
手动注册事件
事件通常是在你服务类 EventService
的 $listen
数组中注册;然而,你也可以在 EventService
的 register
方法中手动注册基于闭包的这些事件:
分发事件
结语
本文的事件系统只是一种代码解耦的写法,并非工具性的依赖包,感兴趣的话可以自己任意扩展。
License
MIT
我的其他项目
guirong/cli-message
github
一个简单易用的,命令行输出样式工具库
guirong/php-router
github
轻量且快速的路由库
guirong/php-closure
github
闭包的序列化和反序列化类库
guirong/php-validate
github
一个轻量级且功能丰富的验证和过滤库