Event_Dispatcher::addObserver

Event_Dispatcher::addObserver() – 新規オブザーバを追加する

Synopsis

require_once 'Event/Dispatcher.php';

void Event_Dispatcher::addObserver ( mixed $callback , string $nName = EVENT_DISPATCHER_GLOBAL , string $class = '' )

Description

ディスパッチャに新規オブザーバを追加します。

オブザーバは PHP コールバックです。これは関数名を文字列、もしくは オブジェクトやクラスとコールするメソッドを含む配列のいずれかで渡す 事を意味します。

コールバックはオブザーバのための署名として使用されます。 これにより removeObserver() に同一のパラメータを渡すことでオブザーバを削除することができます。

Parameter

  • mixed $callback

    通知のためのコールバックで、グローバル関数名を含むを文字列、もしくは クラスやオブジェクトとコールするメソッド名を含む配列のいずれかを 指定します。

  • string $nName = EVENT_DISPATCHER_GLOBAL

    フィルターとして動作し、 通知名がこのパラメータで渡された名前と一致する場合のみ オブザーバに通知します。 オブザーバが通知名に関わらず通知させる場合は EVENT_DISPATCHER_GLOBAL を使用してください。

  • string $class = ''

    フィルターとして動作し、 通知を送信したのがこのパラメータで渡されたクラスにマッチする場合のみ オブザーバに通知します。

Return value

void

Note

This function can not be called statically.