fwk/events

Lightweight Event Dispatcher for Happy Developers

Fwk\Events (Event Dispatcher)

, _(*1)

Event Dispatcher for PHP 5.4+, _(*2)

Installation

Via Composer:, _(*3)

{
    "require": {
        "fwk/events": "dev-master",
    }
}

If you don't use Composer, you can still download this repository and add it to your include_path PSR-0 compatible, _(*4)

Documentation

Adding Listeners

``` php use Fwk\Events\Dispatcher, Fwk\Events\Event;, <sub>(*5)</sub>

$evd = new Dispatcher();, <sub>(*6)</sub>

// closures listeners $evd->on("eventName", function(Fwk\Events\Event $event) { // do some stuff });, <sub>(*7)</sub>

// Class methods starting by "on[EventCamelCasedName]" can also be added as // listeners class MyListener { public function onEventName(Fwk\Events\Event $event) { // do some stuff } }, <sub>(*8)</sub>

$evd->addListener(new MyListener());, <sub>(*9)</sub>

### Removing Listeners

``` php
/* ... */

// this removes all listeners for a given event
$evd->removeAllListeners("eventName");

// this removes a listener (callable) for a given event
$evd->removeListener("eventName", array($listener, "onListenerMethod"));

Trigger Events

``` php /* ... */, <sub>(*10)</sub>

$event = new Fwk\Events\Event("eventName", array( "someData" => "someValue" )); $event->extraData = "extraValue";, <sub>(*11)</sub>

// dispatch event $evd->notify($event); ```, <sub>(*12)</sub>

Contributions / Community

• Issues on Github: https://github.com/fwk/Events/issues
• Follow Fwk on Twitter: @phpfwk

Legal

Fwk is licensed under the 3-clauses BSD license. Please read LICENSE for full details., <sub>(*13)</sub>