Phalcon 事件监听回调，读取事件传递参数写法-php教程-PHP中文网

phalcon中监听事件需回调函数接收$event和$source两个参数：$event为phalcon\events\event实例，通过gettype()和getdata()获取事件名与附带数据；$source为触发事件的对象（如模型实例），业务数据通常从中读取或通过getdata()获取。

phalcon 事件监听回调，读取事件传递参数写法

Phalcon 中监听事件并读取传递参数，关键在于回调函数的签名要匹配事件触发时传入的参数结构。事件系统本身不强制参数类型，但约定回调接收两个参数：第一个是 事件对象（Phalcon\Events\Event），第二个是 事件关联的目标对象（如模型、DI 容器、数据库连接等），部分事件还会在事件对象的 getData() 中携带额外数据。

回调函数正确接收参数写法

标准写法如下：

回调函数必须接受至少两个参数：$event 和 $source
$event 是 Phalcon\Events\Event 实例，可用 $event->getType() 获取事件名，$event->getData() 获取事件附带的数据（可能为 null、数组、字符串或任意值）
$source 是触发该事件的对象（例如 Phalcon\Mvc\Model 实例、Phalcon\Db\Adapter\Pdo\Mysql 等），具体类型取决于事件来源
若需访问事件携带的具体业务参数（如模型保存前的字段值），通常需从 $source 获取（如 $source->toArray()）或检查 $event->getData()

常见事件中参数读取示例

以模型事件为例（如 model:beforeSave）：

BetterYeah AI

BetterYeah AI是一款面向企业的一站式 AI Agent 应用开发平台。

下载

$eventsManager->attach('model', function ($event, $model) {
    if ($event->getType() === 'beforeSave') {
        // $model 就是当前正在保存的 Phalcon\Mvc\Model 实例
        $data = $event->getData(); // 一般为 null，除非手动 trigger 时传入
        $id = $model->id;           // 从模型对象直接读属性
        $values = $model->toArray(); // 获取当前所有字段值
        // 可在此做校验、赋值等操作
        return true;
    }
});

手动触发事件时传参写法

如果你用 $eventsManager->fire() 主动触发事件，并希望传递自定义参数：

fire('type:name', $source, $data) 的第三个参数 $data 会作为 $event->getData() 返回
$data 可以是数组、对象、字符串等任意类型，建议用数组便于扩展
监听回调中通过 $event->getData() 读取，注意判空

示例：

// 触发时传参
$eventsManager->fire('custom:process', $this, ['user_id' => 123, 'action' => 'import']);

// 监听时读取
$eventsManager->attach('custom', function ($event, $source) {
    if ($event->getType() === 'process') {
        $payload = $event->getData();
        if (is_array($payload)) {
            $userId = $payload['user_id'] ?? null;
            $action = $payload['action'] ?? '';
        }
    }
});