dms / chainlink
Chainlink offers a drop in implementation of the Chain of Responsibility implementation.
Installs: 23 734
Dependents: 2
Suggesters: 0
Security: 0
Stars: 6
Watchers: 6
Forks: 2
Open Issues: 5
Requires
- php: >=5.4.0
Requires (Dev)
- mockery/mockery: 0.9.*
- phpunit/phpunit: ~4.5
- scrutinizer/ocular: ~1.1
This package is auto-updated.
Last update: 2024-10-29 04:14:45 UTC
README
Chainlink is a drop in implementation of the Chain of Responsibility pattern. Its a very simple library that helps you avoid boiler plate code in order to provide a chain of responsibility to handle a particular task.
Installation
Chainlink library has been split so that the Context, the class that implements the chain is isolated in this library and adapters and wrapper for popular frameworks are available in separate packages.
If you only need the chain implementation, get chainlink by running:
composer require dms/chainlink
If you use Symfony or other frameworks, check Packagist for wrappers and adapters.
Usage
To use chainlink, all you need to do is implement the HandlerInterface
on your handlers and register them with a context.
class MyHandler implements HandlerInterface { // ... fulfill interface ... } $handler = new MyHandler(); // Create a Context to chain responsibilities $context = new DMS\Chainlink\Context(); $context->addHandler($handler); // Pass in an item to be handled $context->handle($input); // You can also get the handler as a return value $handler = $context->getHandlerFor($input); // You may have need of returning multiple handlers $handler = $context->getAllHandlersFor($input);
Its the handler's responsibility to identify which input it is responsible for, the interface contains a handles
method that is called for that.
Order of Chain handling
Sometimes it's useful to influence which handler gets called first. addHandler
supports an optional second parameter with a priority integer. The highest number in the chain will be called first.
// Create a Context to chain responsibilities $context = new DMS\Chainlink\Context(); $context->addHandler($handler1, 10); $context->addHandler($handler2, 1000); $context->addHandler($handler3); // Pass in an item to be handled $context->handle($input);
The following handlers will be called in order (provided they can handle the usecase) $handler2 -> $handler1 -> $handler3