Action request handler factory

This package provides an action request handler factory which can be used to produce Psr-15 request handler from an action string., _(*1)

Require php >= 7.1, _(*2)

Installation composer require ellipse/handlers-action, _(*3)

Run tests ./vendor/bin/peridot tests, _(*4)

Using the action request handler factory

Using the action request handler factory

Action strings are string containing a class name and method name spaced by @. A comma separated list of request attributes to inject can be added, spaced by :., _(*5)

Example: 'App\Controller@index' or 'App\Controller@show:category_id,post_id'., _(*6)

Many things to note:, _(*7)

The action's controller instance is constructed using ellipse/container auto-wiring feature. See auto-wiring documentation for more details.
The action's method is called using ellipse/container callable dependency injection feature. See callable dependency injection documentation for more details.
When one parameter of the action's controller constructor or action's method is type hinted as Psr\Http\Message\ServerRequestInterface, the request currently processed by the request handler is injected
The non type hinted parameters of the action's controller constructor or action's method will be the specified request attributes, in the order they are listed
When a 'router.controllers.namespace' alias is registered in the container, its value will be prepended to all controller class names

<?php

namespace App;

class SomeController
{
    private $response;

    public function __construct(ResponseFactory $response)
    {
        // Dependencies are automatically injected.

        $this->response = $response;
    }

    public function index(ServerRequestInterface $request, $request_attribute)
    {
        // $request is the request available at the time the middleware is being processed.
        // $request_attribute is the first url attribute passed to the Action instance.

        // some processing ...

        // returns a response.
        return $this->response->create();
    }
}

<?php

namespace App;

use Simplex\Container;

use Ellipse\Handlers\ActionFactory;

// Get a Psr-11 container.
$container = new Container;

// Register a base controllers namespace.
$container->set('router.controllers.namespace', 'App');

// Get an action factory using this container.
$factory = new ActionFactory($container);

// Create a request handler based on SomeController's index method.
$handler = $factory('SomeController@index:request_attribute');

05/12 2017

dev-master

9999999-dev https://github.com/ellipsephp/handlers-action

The action request handler factory component of the ellipse framework

Sources Download

MIT

The Requires

The Development Requires

by Pierre Mallinjoud

psr-7 request resolver controller factory action psr-15 request-handler

library handlers-action