fspringveldt/silverstripe-event-mediator

A Silverstripe event emitter based on the mediator pattern

SilverStripe Event Mediator

A SilverStripe event emitter based on the mediator pattern, which can be applied to run a bit of code before or after any class method (i.e. triggered) using Silverstripe's Aspects, _(*1)

Requirements

"silverstripe/framework": "3.*"
"composer"

Installation

To install, run below from root of SilverStripe installation:, _(*2)

> composer require fspringveldt/silverstripe-event-mediator

http://your-site-url?flush=1 once composer is complete the flush the manifest., _(*3)

Configuration 1 - Extension based (default)

Installing the module adds the eventMediator\EventExtension to DataObject. Let's say after each call to $A->foo() you'd like to fire off a call to $B->bar(), the following added to your composer.yml sets up the events:, _(*4)

Injector:
  eventMediator\EventMediator':
    properties:
      events:
        foo:
          triggerBar:
            class: B
            method: bar

then in $A->foo() do the following:, _(*5)

class A{
    function foo(){
        //foo funciton body

        $this->emit(__FUNCTION__);
    }
}

Configuration 2 - Aspect using AopProxyService

Let's say after each call to $A->foo() you'd like to fire off a call to $B->bar(), the following in your composer.yml should do the trick:, _(*6)

Injector:
  'eventMediator\EventMediator':
    properties:
      events:
        foo:
          triggerBar:
            class: B
            method: bar
  ProxiedA:
    class: A
  A:
    class: AopProxyService
    properties:
      proxied: %$ProxiedA
      afterCall:
        foo:
          - %$eventMediator\EventMediator'

All parameters from $A->foo() are sent through $B->foo() for your perusal., _(*7)