Download the PHP package ellipse/handlers-adr without Composer

Request handler ADR

This package provides a Psr-15 request handler implementing the Action-Domain-Responder pattern.

Require php >= 7.0

Installation composer require ellipse/handlers-adr

Run tests ./vendor/bin/kahlan

• Request handler using ADR pattern
• Usage with a Psr-11 container

Request handler using ADR pattern

The Action-Domain-Responder (ADR) pattern is used to separate domain and presentation logic of an application. It can be summed up as having Action objects gluing together pairs of Domain and Responder objects in order to produce a response from an incoming request. An Action can therefore be considered as a Psr-15 request handler and the goal of this package is to provide an ADR implementation usable with any Psr-15 dispatching system.

The Ellipse\Handlers\ActionRequestHandler represents a generic Action implementing Psr\Http\Server\RequestHandlerInterface. Its first constructor parameter is a Domain object implementing Ellipse\ADR\DomainInterface and the second one is a Responder object implementing Ellipse\Handler\ResponderInterface. Here is what's going on when the ->handle() method of an ActionRequestHandler instance is called with a Psr-7 request:

• An input array is extracted from the Psr-7 request
• A payload is produced by calling the ->payload() method of the Domain with the input array
• A Psr-7 response is produced by calling the ->response() method of the Responder with the Psr-7 request and the payload
• The Psr-7 response is returned

By default the input array is obtained by merging the request attributes, query parameters, parsed body parameters and uploaded files. They are merged in this order, meaning request attributes are overridden by query parameters having the same keys, which in turn are overridden by parsed body parameters, and finally by uploaded files. An Action specific request parsing logic can be specified by passing a callable as ActionRequestHandler third constructor parameter. This request parser callable is executed with the request as parameter and must return an array. An Ellipse\Handlers\Exceptions\InputTypeException is thrown when anything else than an array is returned.

DomainInterface defines a ->payload() method taking an input array as parameter and returning an implementation of Ellipse\ADR\PayloadInterface.

PayloadInterface defines two methods: ->status() returning the payload status as a string and ->data() returning the payload data as an array. The Ellipse\ADR\Payload class can be used as a default implementation of PayloadInterface. It takes the status string and the data array as constructor parameters.

Finally, ResponseInterface defines a ->response() method taking a request and an implementation of PayloadInterface as parameter and returning a response.

Usage with a Psr-11 container

In real world applications Domain and Responder instances are usually retrieved from a container.

This packages provides implementations of DomainInterface and ResponderInterface proxying a Psr-11 container entry.

Ellipse\Handlers\ContainerDomain class takes a container and the container id of a Domain object as constructor parameters. When its ->payload() method is called, the Domain is retrieved from the container and the payload produced by its ->payload() method is returned. An Ellipse\Handlers\Exceptions\ContainedDomainTypeException is thrown when the container entry is not an implementation of DomainInterface.

In the same way Ellipse\Handlers\ContainerResponder class takes a container and the container id of a Responder object as constructor parameters. The container entry ->response() method is proxied and an Ellipse\Handlers\Exceptions\ContainedResponderTypeException is thrown when it is not an implementation of ResponderInterface.

Finally, request parsing callables can also be retrieved from the container using the Ellipse\Handlers\ContainerRequestParser class with a container and the container id of a callable as constructor parameters. An Ellipse\Handlers\Exceptions\ContainedRequestParserTypeException is thrown when the container entry is not a callable.

Of course Domain and Responder classes can be auto wired using Ellipse\Container\ReflectionContainer class from the ellipse/container-reflection package.