A PSR-15 middleware for hierarchical dispatching based on path prefixes

v1.0.0 2018-09-23 20:07 UTC


Latest Version on Packagist Software License Build Status Quality Score Total Downloads

A middleware dispatching to other middleware stacks, based on different path prefixes.



This package is installable and autoloadable via Composer as middlewares/base-path-router.

composer require middlewares/base-path-router

You may also want to install middlewares/request-handler.


This example uses middleware/request-handler to execute the route handler:

$dispatcher = new Dispatcher([
    new Middlewares\BasePathRouter([
        '/admin' => $admin,
        '/admin/login' => $adminLogin,
        '/blog' => $blog,
    new Middlewares\RequestHandler()

$response = $dispatcher->dispatch(new ServerRequest());

BasePathRouter allows anything to be defined as the router handler (a closure, callback, action object, controller class, etc). The middleware will store this handler in a request attribute.


__construct(array $middlewares)

Array with the paths (as keys) and handlers (as values).


Set true to continue to the next middleware instead return an empty 404 response for non-matching requests (i.e. those that do not have an URI path start with one of the provided prefixes).

stripPrefix(bool $stripPrefix)

By default, subsequent middleware will receive a slightly manipulated request object: any matching path prefixes will be stripped from the URI. This helps when you have a hierarchical setup of routers, where subsequent routers (e.g. one for the API stack mounted under the /api endpoint) can ignore the common prefix.

If you want to disable this behavior, use the stripPrefix method:

$router = (new Middlewares\BasePathRouter([
        '/prefix1' => $middleware1,

attribute(string $attribute)

The attribute name used to store the handler in the server request. The default attribute name is request-handler.

Please see CHANGELOG for more information about recent changes and CONTRIBUTING for contributing details.

The MIT License (MIT). Please see LICENSE for more information.