Skip to content

siriusphp/invokator

Repository files navigation

Sirius Invokator

Source Code Latest Version Software License Build Status Total Downloads

Sirius Invokator is a library that implements a unified way to execute a list of commands/callables that are used by various patterns:

  1. middlewares
  2. pipelines
  3. events
  4. command bus (with middleware)
  5. actions a la Wordpress
  6. filters a la Wordpress

All of the above patterns have in common that they are actually a list of callables, and they differ in the way they are executed in different ways.

In the case of middlewares, the starting parameter (eg: a HTTP request) is passed from one callable to the next, each callable having the option to terminate with a result or call the next callable in the list.

In the case of pipelines, the result of each callable is passed to the next callable and the last callable will return the result of the pipeline

In the case of events, an event object is passed through each callable in the list and each callable is independent.

In th case of the command buss, a command object is sent to be handled by only one callable.

Elevator pitch

use Sirius\Invokator\Invoker;
use Sirius\Invokator\Processors\PipelineProcessor;
use Sirius\Invokator\CallableCollection;

$container = app(); // your application DI container
$invoker = new Invoker($container)
$processor = new PipelineProcessor($invoker);

$processor->add('pipeline_name', 'trim');
$processor->add('pipeline_name', 'Str::toUppercase');
$processor->add('pipeline_name', function($value) {             // anonymous function
    return $value . '!!!';
});
$processor->add('pipeline_name', 'Logger@info');

$processor->process('pipeline_name', "  hello world  "); // returns `HELLO WORLD!!!`

Where to next?

About

PHP library to execute stacks of callables using various patterns (middleware, pipelines, events)

Resources

License

Stars

Watchers

Forks

Packages

No packages published