Event_Dispatcher::addNestedDispatcher() – Add a nested dispatcher.


require_once 'Event/Dispatcher.php';

void Event_Dispatcher::addNestedDispatcher ( object Event_Dispatcher &$dispatcher )


Adds a nested dispatcher to the dispatcher.

Nested dispatchers allow you to create event bubbling like it is implemented in Javascript. After an event has been posted to all observers of the dispatcher, it will be broadcasted to all nested dispatchers.

If you have one dispatcher that dispatches events of a component in your framework and one dispatcher that dispatches global events that are triggered by the framework itself it could make sense that you nest these dispatchers, so that events posted by the component dispatcher will also be broadcasted to the global dispatcher.


  • object Event_Dispatcher &$dispatcher

    Dispatcher that should be added as a nested dispatcher to the current dispatcher.

Return value



This function can not be called statically.

Post a notification. (Previous) Remove a nested dispatcher. (Next)
Last updated: Sat, 16 Feb 2019 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report.
View this page in:
  • English

User Notes:

There are no user contributed notes for this page.