innmind/router

HTTP router

5.0.0 2025-08-15 15:33 UTC

Requires

• php: ~8.2
• innmind/http: ~8.0
• innmind/immutable: ~5.18
• innmind/url: ~4.1
• innmind/url-template: ~3.0

Requires (Dev)

• innmind/black-box: ~6.5
• innmind/coding-standard: ~2.0
• innmind/static-analysis: ^1.2.1

MIT

• Baptiste Langlade

• http
• router

README

Monadic HTTP router.

Note

This package has been heavily inspired from F# Giraffe.

Installation

composer require innmind/router

Usage

use Innmind\Router\{
    Router,
    Any,
    Method,
    Endpoint,
    Handle,
};
use Innmind\Http\{
    ServerRequest,
    Response,
    Response\StatusCode,
};

$router = Router::of(
    Any::of(
        Method::post()
            ->pipe(Endpoint::of('/url{/template}'))
            ->pipe(Handle::of(static fn(ServerRequest $request, string $template) => Response::of(
                StatusCode::ok,
                $request->protocolVersion(),
            ))),
        Method::delete()
            ->pipe(Endpoint::of('/resource/{id}'))
            ->pipe(Handle::of(static fn(ServerRequest $request, string $id) => Response::of(
                StatusCode::ok,
                $request->protocolVersion(),
            ))),
    ),
);

$response = $router(/* instance of ServerRequest */)->unwrap(); // Response

Building a simple app

Example using the innmind/http-server package to respond with files stored in a private folder.

use Innmind\Router\{
    Router,
    Any,
    Method,
    Endpoint,
    Handle,
};
use Innmind\HttpServer\Main;
use Innmind\OperatingSystem\OperatingSystem;
use Innmind\Http\{
    ServerRequest,
    Response,
    Response\StatusCode,
};
use Innmind\Filesystem\Name;
use Innmind\Url\Path;

new class extends Main {
    private Router $router;

    protected function preload(OperatingSystem $os): void
    {
        $this->router = Router::of(Any::of(
            Method::get()
                ->pipe(Endpoint::of('/image/{name}'))
                ->pipe(Handle::of(static fn(string $name) => self::loadFile(
                    $os,
                    $name,
                ))),
            Method::get()
                ->pipe(Endpoint::of('/image/random'))
                ->pipe(Handle::of(static fn() => self::loadFile(
                    $os,
                    generateRandomName(),
                ))),
        ));
    }

    protected function main(ServerRequest $request): Response
    {
        return ($this->router)($request)->match(
            static fn($response) => $response,
            static fn() => Response::of(
                StatusCode::notFound,
                $request->protocolVersion(),
            ),
        );
    }

    private function loadFile(OperatingSystem $os, string $name): Response
    {
        return $os
            ->filesystem()
            ->mount(Path::of('some/private/folder/'))
            ->unwrap()
            ->get(Name::of($name))
            ->match(
                static fn($file) => Response::of(
                    StatusCode::ok,
                    $request->protocolVersion(),
                    null,
                    $file->content(),
                ),
                static fn() => Response::of(
                    StatusCode::notFound,
                    $request->protocolVersion(),
                ),
            );
    }
}