gnatsnapper/altorouter-middleware

A PSR-15 Middleware to allow the use of the venerable AltoRouter in Middleware-based PHP applications

v0.0.2 2020-08-14 07:42 UTC

Requires

• php: ^7.3
• altorouter/altorouter: ^2.0
• psr/http-message: ^1.0
• psr/http-server-middleware: ^1.0

Requires (Dev)

• laminas/laminas-diactoros: ^2.3
• laminas/laminas-stratigility: ^3.2
• phpunit/phpunit: ^9.2
• squizlabs/php_codesniffer: ^3.5
• vimeo/psalm: ^3.12

GPL-3.0-or-later

• middleware
• psr
• psr-15

README

AltoRouter Middleware

Install

composer require gnatsnapper/altorouter-middleware

Usage

This class simply extends the venerable AltoRouter class to allow use as a router/dispatcher. If a route is not found the request is passed to the next middleware. If a route is mapped the AltoRouter will produce a response, therefore the route must be a callable returning an object implementing Psr\Http\Message\ResponseInterface.

$altorouter = new AltoRouterMiddleware();

//map array of routes

$altorouter->addRoutes(
[
    [
        'GET',
        '/',
        function () {
             $r = new Response();
             $r->getBody()->write('home');
             return $r;
        }
    ],
    [
        'GET',
        '/users',
        function () {
             $r = new Response();
             $r->getBody()->write('users');
             return $r;
        }
    ]

]
);

//or map single route

$altorouter->map(
        'GET',
        '/admin',
        function () {
             $r = new Response();
             $r->getBody()->write('admin');
             return $r;
        }
    );

Then add this middleware to the applications middleware pipeline.