# 事件管理器（Events Manager）
此组件的目的是为了通过创建“钩子”拦截框架中大部分的组件操作。 这些钩子允许开发者获得状态信息，操纵数据或者改变某个组件进程中的执行流向。
## Naming Convention
Phalcon events use namespaces to avoid naming collisions. Each component in Phalcon occupies a different event namespace and you are free to create your own as you see fit. Event names are formatted as “component:event”. For example, as[Phalcon\\Db](http://docs.iphalcon.cn/api/Phalcon_Db.html)occupies the “db” namespace, its “afterQuery” event’s full name is “db:afterQuery”.
When attaching event listeners to the events manager, you can use “component” to catch all events from that component (eg. “db” to catch all of the[Phalcon\\Db](http://docs.iphalcon.cn/api/Phalcon_Db.html)events) or “component:event” to target a specific event (eg. “db:afterQuery”).
## 使用示例（Usage Example）
In the following example, we will use the EventsManager to listen for the “afterQuery” event produced in a MySQL connection managed by[Phalcon\\Db](http://docs.iphalcon.cn/api/Phalcon_Db.html):
~~~
<?php
use Phalcon\Events\Event;
use Phalcon\Events\Manager as EventsManager;
use Phalcon\Db\Adapter\Pdo\Mysql as DbAdapter;
$eventsManager = new EventsManager();
$eventsManager->attach(
"db:afterQuery",
function (Event $event, $connection) {
echo $connection->getSQLStatement();
}
);
$connection = new DbAdapter(
[
"host" => "localhost",
"username" => "root",
"password" => "secret",
"dbname" => "invo",
]
);
// 将$eventsManager赋值给数据库甜适配器
$connection->setEventsManager($eventsManager);
// 发送一个SQL命令到数据库服务器
$connection->query(
"SELECT * FROM products p WHERE p.status = 1"
);
~~~
Now every time a query is executed, the SQL statement will be echoed out. 第一个传递给事件侦听者的参数包含了关于正在运行事件的上下文信息，第二个则是连接本身。 A third parameter may also be specified which will contain arbitrary data specific to the event.
> You must explicitly set the Events Manager to a component using the`setEventsManager()`method in order for that component to trigger events. You can create a new Events Manager instance for each component or you can set the same Events Manager to multiple components as the naming convention will avoid conflicts.
Instead of using lambda functions, you can use event listener classes instead. Event listeners also allow you to listen to multiple events. 作为些示例的一部分，我们同样实现了[Phalcon\\Db\\Profiler](http://docs.iphalcon.cn/api/Phalcon_Db_Profiler.html)来检测SQL语句是否超出了期望的执行时间：
~~~
<?php
use Phalcon\Db\Profiler;
use Phalcon\Events\Event;
use Phalcon\Logger;
use Phalcon\Logger\Adapter\File;
class MyDbListener
{
protected $_profiler;
protected $_logger;
/**
*创建分析器并开始纪录
*/
public function __construct()
{
$this->_profiler = new Profiler();
$this->_logger = new Logger("../apps/logs/db.log");
}
/**
* 如果事件触发器是'beforeQuery'，此函数将会被执行
*/
public function beforeQuery(Event $event, $connection)
{
$this->_profiler->startProfile(
$connection->getSQLStatement()
);
}
/**
* 如果事件触发器是'afterQuery'，此函数将会被执行
*/
public function afterQuery(Event $event, $connection)
{
$this->_logger->log(
$connection->getSQLStatement(),
Logger::INFO
);
$this->_profiler->stopProfile();
}
public function getProfiler()
{
return $this->_profiler;
}
}
~~~
Attaching an event listener to the events manager is as simple as:
~~~
<?php
// 创建一个数据库侦听
$dbListener = new MyDbListener();
// 侦听全部数据库事件
$eventsManager->attach(
"db",
$dbListener
);
~~~
可以从侦听者中获取结果分析数据：
~~~
<?php
// 发送一个SQL命令到数据库服务器
$connection->execute(
"SELECT * FROM products p WHERE p.status = 1"
);
foreach ($dbListener->getProfiler()->getProfiles() as $profile) {
echo "SQL语句: ", $profile->getSQLStatement(), "\n";
echo "开始时间: ", $profile->getInitialTime(), "\n";
echo "结束时间: ", $profile->getFinalTime(), "\n";
echo "总共执行的时间: ", $profile->getTotalElapsedSeconds(), "\n";
}
~~~
## 创建组件触发事件（Creating components that trigger Events）
你可以在你的应用中为事件管理器的触发事件创建组件。这样的结果是，可以有很多存在的侦听者为这些产生的事件作出响应。 在以下的示例中，我们将会创建一个叫做“MyComponent”组件。这是个意识事件管理器组件； 当它的方法:code:[`](http://docs.iphalcon.cn/reference/events.html#id1)someTask()`被执行时它将触发事件管理器中全部侦听者的两个事件：
~~~
<?php
use Phalcon\Events\ManagerInterface;
use Phalcon\Events\EventsAwareInterface;
class MyComponent implements EventsAwareInterface
{
protected $_eventsManager;
public function setEventsManager(ManagerInterface $eventsManager)
{
$this->_eventsManager = $eventsManager;
}
public function getEventsManager()
{
return $this->_eventsManager;
}
public function someTask()
{
$this->_eventsManager->fire("my-component:beforeSomeTask", $this);
// 做一些你想做的事情
echo "这里, someTask\n";
$this->_eventsManager->fire("my-component:afterSomeTask", $this);
}
}
~~~
Notice that in this example, we’re using the “my-component” event namespace. 现在让我们来为这个组件创建一个侦听者：
~~~
<?php
use Phalcon\Events\Event;
class SomeListener
{
public function beforeSomeTask(Event $event, $myComponent)
{
echo "这里, beforeSomeTask\n";
}
public function afterSomeTask(Event $event, $myComponent)
{
echo "这里, afterSomeTask\n";
}
}
~~~
现在让我们把全部的东西整合起来：
~~~
<?php
use Phalcon\Events\Manager as EventsManager;
// 创建一个事件管理器
$eventsManager = new EventsManager();
// 创建MyComponent实例
$myComponent = new MyComponent();
// 将事件管理器绑定到创建MyComponent实例实例
$myComponent->setEventsManager($eventsManager);
// 为事件管理器附上侦听者
$eventsManager->attach(
"my-component",
new SomeListener()
);
// 执行组件的方法
$myComponent->someTask();
~~~
当:code:[`](http://docs.iphalcon.cn/reference/events.html#id3)someTask()`被执行时，在侦听者里面的两个方法将会被执行，并产生以下输出：
~~~
这里, beforeSomeTask
这里, someTask
这里, afterSomeTask
~~~
当触发一个事件时也可以使用:code:[`](http://docs.iphalcon.cn/reference/events.html#id5)fire()`中的第三个参数来传递额外的数据：
~~~
<?php
$eventsManager->fire("my-component:afterSomeTask", $this, $extraData);
~~~
在一个侦听者里，第三个参数可用于接收此参数：
~~~
<?php
use Phalcon\Events\Event;
// 从第三个参数接收数据
$eventsManager->attach(
"my-component",
function (Event $event, $component, $data) {
print_r($data);
}
);
// 从事件上下文中接收数据
$eventsManager->attach(
"my-component",
function (Event $event, $component) {
print_r($event->getData());
}
);
~~~
## Using Services From The DI
By extending[Phalcon\\Mvc\\User\\Plugin](http://docs.iphalcon.cn/api/Phalcon_Mvc_User_Plugin.html), you can access services from the DI, just like you would in a controller:
~~~
<?php
use Phalcon\Events\Event;
use Phalcon\Mvc\User\Plugin;
class SomeListener extends Plugin
{
public function beforeSomeTask(Event $event, $myComponent)
{
echo "Here, beforeSomeTask\n";
$this->logger->debug(
"beforeSomeTask has been triggered";
);
}
public function afterSomeTask(Event $event, $myComponent)
{
echo "Here, afterSomeTask\n";
$this->logger->debug(
"afterSomeTask has been triggered";
);
}
}
~~~
## 事件传播与取消（Event Propagation/Cancellation）
可能会有多个侦听者添加到同一个事件管理器，这意味着对于相同的事件会通知多个侦听者。 这些侦听者会以它们在事件管理器注册的顺序来通知。有些事件是可以被取消的，暗示着这些事件可以被终止以防其他侦听都再收到事件的通知：
~~~
<?php
use Phalcon\Events\Event;
$eventsManager->attach(
"db",
function (Event $event, $connection) {
// 如果可以取消，我们就终止此事件
if ($event->isCancelable()) {
// 终止事件，这样的话其他侦听都就不会再收到此通知
$event->stop();
}
// ...
}
);
~~~
默认情况下全部的事件都是可以取消的，甚至框架提供的事件也是可以取消的。 你可以通过在`fire()`中的第四个参数中传递`false`来指明这是一个不可取消的事件：
~~~
<?php
$eventsManager->fire("my-component:afterSomeTask", $this, $extraData, false);
~~~
## 侦听器优先级（Listener Priorities）
当附上侦听者时，你可以设置一个优先级。使用此特性，你可以指定这些侦听者被调用的固定顺序：
~~~
<?php
$eventsManager->enablePriorities(true);
$eventsManager->attach("db", new DbListener(), 150); // 高优先级
$eventsManager->attach("db", new DbListener(), 100); // 正常优先级
$eventsManager->attach("db", new DbListener(), 50); // 低优先级
~~~
## 收集响应（Collecting Responses）
事件管理器可以收集每一个被通知的侦听者返回的响应，以下这个示例解释了它是如何工作的：
~~~
<?php
use Phalcon\Events\Manager as EventsManager;
$eventsManager = new EventsManager();
// 建立事件管理器以为收集结果响应
$eventsManager->collectResponses(true);
// 附上一个侦听者
$eventsManager->attach(
"custom:custom",
function () {
return "first response";
}
);
// 附上一个侦听者
$eventsManager->attach(
"custom:custom",
function () {
return "second response";
}
);
// 执行fire事件
$eventsManager->fire("custom:custom", null);
// 获取全部收集到的响应
print_r($eventsManager->getResponses());
~~~
上面示例将输出：
~~~
Array ( [0] => first response [1] => second response )
~~~
## 自定义事件管理器（Implementing your own EventsManager）
如果想要替换Phalcon提供的事件管理器，必须实现[Phalcon\\Events\\ManagerInterface](http://docs.iphalcon.cn/api/Phalcon_Events_ManagerInterface.html)中的接口。
- 简介
- 安装
- 安装(installlation)
- XAMPP下的安装
- WAMP下安装
- Nginx安装说明
- Apache安装说明
- Cherokee 安装说明
- 使用 PHP 内置 web 服务器
- Phalcon 开发工具
- Linux 系统下使用 Phalcon 开发工具
- Mac OS X 系统下使用 Phalcon 开发工具
- Windows 系统下使用 Phalcon 开发工具
- 教程
- 教程 1：让我们通过例子来学习
- 教程 2：INVO简介
- 教程 3: 保护INVO
- 教程4: 使用CRUD
- 教程5: 定制INVO
- 教程 6: Vökuró
- 教程 7：创建简单的 REST API
- 组件
- 依赖注入与服务定位器
- MVC架构
- 使用控制器
- 使用模型
- 模型关系
- 事件与事件管理器
- Behaviors
- 模型元数据
- 事务管理
- 验证数据完整性
- Workingwith Models
- Phalcon查询语言
- 缓存对象关系映射
- 对象文档映射 ODM
- 使用视图
- 视图助手
- 资源文件管理
- Volt 模版引擎
- MVC 应用
- 路由
- 调度控制器
- Micro Applications
- 使用命名空间
- 事件管理器
- Request Environmen
- 返回响应
- Cookie 管理
- 生成 URL 和 路径
- 闪存消息
- 使用 Session 存储数据
- 过滤与清理
- 上下文编码
- 验证Validation
- 表单_Forms
- 读取配置
- 分页 Pagination
- 使用缓存提高性能
- 安全
- 加密与解密 Encryption/Decryption
- 访问控制列表
- 多语言支持
- 类加载器 Class Autoloader
- 日志记录_Logging
- 注释解析器 Annotations Parser
- 命令行应用 Command Line Applications
- Images
- 队列 Queueing
- 数据库抽象层
- 国际化
- 数据库迁移
- 调试应用程序
- 单元测试
- 进阶技巧与延伸阅读
- 提高性能：下一步该做什么？
- Dependency Injection Explained
- Understanding How Phalcon Applications Work
- Api
- Abstract class Phalcon\Acl