Как $ event используется в "Logic hooks"?

Question

Я вижу этот пример кода, который содержит метод с именем StampIt, который имеет 2 аргумента $ 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/

Answer 1

$event будет содержать имя текущего выполняемого типа события / типа ловушки во время выполнения.Это полезно, если один метод подключен к более чем одному событию и должен изменить свою логику в зависимости от того, какое событие его вызвало.

В этом конкретном примере мы знаем, что $event всегда будет содержать строку before_safe поскольку это единственное событие, к которому подключен наш метод-пример.Никакое другое событие никогда не вызовет этот метод.

Вот почему переменная остается неиспользованной в этом примере, так как метод в любом случае не должен обрабатывать больше, чем этот единственный тип события, и также не получит никакой новой информациичтение $event.