2017 © Pedro Peláez
 

contao-module event-dispatcher

Event dispatcher service for Contao Open Source CMS

image

designs2/event-dispatcher

Event dispatcher service for Contao Open Source CMS

  • Saturday, October 31, 2015
  • by MoniqueHahnefeld
  • Repository
  • 0 Watchers
  • 0 Stars
  • 17 Installations
  • PHP
  • 4 Dependents
  • 0 Suggesters
  • 3 Forks
  • 0 Open issues
  • 7 Versions
  • 0 % Grown

The README.md

Version ![Stable Build Status](http://img.shields.io/travis/contao-community-alliance/event-dispatcher/master.svg?style=flat-square&label=stable build) ![Upstream Build Status](http://img.shields.io/travis/contao-community-alliance/event-dispatcher/develop.svg?style=flat-square&label=dev build) License Downloads, (*1)

Event dispatcher for Contao Open Source CMS

Why an event dispatcher for Contao Open Source CMS, are the hooks not enough? First you need to understand, there is no real difference between hooks and events. The are both notifications from within the system., (*2)

But events are more elastic than hooks. They can be hand round, consumed, stopped or bubble upon a hierarchy., (*3)

The real big reasons, why an event dispatcher exists for Contao are:, (*4)

  1. Events are standard paradigm in software design.
  2. Hooking is a paradigm to alter the behavior of a software, is it not designed for notifications.
  3. Hooks are only a special form of events.
  4. The symfony event dispatcher this extension based on is widely used.
  5. The event dispatcher can handle every form of callbacks, like closures or static methods.

Listen on events

The event dispatcher provide two ways to listen on events., (*5)

First and mostly used is an event listener. It is designed to listen on a single event., (*6)

Second the event subscriber is designed to listen on multiple events., (*7)

Event listener per configuration

Since version 1.3 there are two ways to define your listeners per configuration., (*8)

/config/event_listeners.php

We recommend to use this method!, (*9)

The file /config/event_listeners.php must return an array of event names as keys and listeners as values., (*10)

<?php
return array(
    // With a closure
    'event-name' => array(
        function($event) {
            // event code
        }
    ),

    // With a static callable
    'event-name' => array(
        array('MyEventListener', 'myCallable')
    ),

    // With an object callable
    'event-name' => array(
        array(new MyEventListener(), 'myCallable')
    ),

    // With a service object
    'event-name' => array(
        array($GLOBALS['container']['my_event_listener'], 'myCallable')
    ),

    // You can wrap the listener into an array with a priority
    'event-name' => array(
        array($listener, $priority)
    ),
);

/config/config.php

In your /config/config.php use $GLOBALS['TL_EVENTS'] to register your event handlers., (*11)

With a closure:, (*12)

$GLOBALS['TL_EVENTS']['event-name'][] = function($event) {
    // event code
};

With a static callable:, (*13)

$GLOBALS['TL_EVENTS']['event-name'][] = array('MyEventListener', 'myCallable');

With an object callable:, (*14)

$GLOBALS['TL_EVENTS']['event-name'][] = array(new MyEventListener(), 'myCallable');

Handle with priority

To define the priority, you can use an array with the listener as first and the priority as second element., (*15)

$GLOBALS['TL_EVENTS']['event-name'][] = array($listener, $priority);

Event listener per code

$container['event-dispatcher']->addListener('event-name', $listener);

Event subscriber per configuration

Since version 1.3 there are two ways to define your listeners per configuration., (*16)

/config/event_subscribers.php

We recommend to use this method!, (*17)

The file /config/event_subscribers.php must return an array of subscribers., (*18)

<?php
return array(
    // With a factory
    function($eventDispatcher) {
        return new MyEventSubscriber();
    },

    // With an object class name
    'MyEventSubscriber',

    // With an object instance
    new MyEventSubscriber(),

    // With a service object
    $GLOBALS['container']['my_event_subscriber'],
);

/config/config.php

In your /config/config.php use $GLOBALS['TL_EVENT_SUBSCRIBERS'] to register your subscribers., (*19)

With a factory:, (*20)

$GLOBALS['TL_EVENT_SUBSCRIBERS'][] = function($eventDispatcher) {
    return new MyEventSubscriber();
};

With an object class name:, (*21)

$GLOBALS['TL_EVENT_SUBSCRIBERS'][] = 'MyEventSubscriber';

With an object instance:, (*22)

$GLOBALS['TL_EVENT_SUBSCRIBERS'][] = new MyEventSubscriber();

Event subscriber per code

$container['event-dispatcher']->addSubscriber(new MyEventSubscriber());

The Versions

31/10 2015

dev-master

9999999-dev http://c-c-a.org/

Event dispatcher service for Contao Open Source CMS

  Sources   Download

LGPL-3.0+

The Requires

 

The Development Requires

by Tristan Lins

event contao

28/11 2014

dev-develop

dev-develop http://c-c-a.org/

Event dispatcher service for Contao Open Source CMS

  Sources   Download

LGPL-3.0+

The Requires

 

The Development Requires

by Tristan Lins

event contao

28/11 2014

1.3.0

1.3.0.0 http://c-c-a.org/

Event dispatcher service for Contao Open Source CMS

  Sources   Download

LGPL-3.0+

The Requires

 

The Development Requires

by Tristan Lins

event contao

05/06 2014

1.2

1.2.0.0 http://c-c-a.org/

Event dispatcher service for Contao Open Source CMS

  Sources   Download

LGPL-3.0+

The Requires

 

by Tristan Lins

event contao

27/05 2014

1.1.1

1.1.1.0 http://c-c-a.org/

Event dispatcher service for Contao Open Source CMS

  Sources   Download

LGPL-3.0+

The Requires

 

by Tristan Lins

event contao

19/03 2014

1.1

1.1.0.0 http://c-c-a.org/

Event dispatcher service for Contao Open Source CMS

  Sources   Download

LGPL-3.0+

The Requires

 

by Tristan Lins

event contao

19/12 2013

1.0

1.0.0.0

Event dispatcher service for Contao Open Source CMS

  Sources   Download

LGPL-3.0+

The Requires

 

by Tristan Lins

event contao