$event在"Logic hooks"中如何使用?

How is $event used in "Logic hooks"?

我看到这个示例代码包含一个名为 StampIt 的方法,它有两个参数 $focus 和 $event

class AddTimeStamp
{
    function StampIt(& $focus, $event)
    {
        global $current_user;
        $focus->description .= "Saved on ". date("Y-m-d g:i a"). " by ". $current_user->user_name;         }
}

我只是想了解在哪里使用了 $event 参数,因为 StampIt 方法中的任何地方都没有提到它

来源:http://support.sugarcrm.com/Documentation/Sugar_Developer/Sugar_Developer_Guide_6.5/Application_Framework/Module_Builder/Introduction/

$event 将包含运行时当前正在执行的 event/hook 类型的名称。 如果单个方法挂接到多个事件并且需要根据触发它的事件更改其逻辑,这将很有用。

在这个特定的示例中,我们知道 $event 将始终包含字符串 before_safe,因为这是我们的示例方法挂钩的唯一事件。没有其他事件会调用该方法。

这就是该示例中未使用该变量的原因,因为该方法无论如何都不必处理超过该单一事件类型,并且也不会通过读取 $event.[=14 获得任何新信息=]