solophp/router

A high-performance PHP router with middleware support, route groups, named routes, and advanced optional segment patterns.

v3.0.0 2025-12-06 14:49 UTC

Requires

• php: >=8.1
• solophp/contracts: ^1.2

Requires (Dev)

• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^12.4
• squizlabs/php_codesniffer: ^3.7

MIT

• Vitaliy Olos

• routing
• router
• middleware
• PSR-4
• php-router
• php8
• route-groups
• named-routes

README

High-performance PHP router with middleware support, route groups, named routes, and advanced optional segment patterns.

Features

• High Performance — Static routes use O(1) hash lookup, pattern caching
• Fluent API — Chainable ->name() and ->middleware() methods
• Route Groups — Shared prefixes and middleware with nesting
• Middleware — Single and multiple middleware per route/group
• Advanced Patterns — Optional segments anywhere, nested optionals, regex constraints
• Named Routes — Easy route referencing for URL generation

Installation

composer require solophp/router

Quick Example

use Solo\Router\RouteCollector;

$router = new RouteCollector();

// Simple routes
$router->get('/users', [UserController::class, 'index']);
$router->get('/users/{id}', [UserController::class, 'show']);

// Route with middleware and name
$router->post('/posts', [PostController::class, 'store'])
    ->middleware(AuthMiddleware::class)
    ->name('posts.store');

// Route groups
$router->group('/admin', function(RouteCollector $router) {
    $router->get('/dashboard', [AdminController::class, 'dashboard']);
    $router->get('/users', [AdminController::class, 'users']);
}, [AuthMiddleware::class]);

// Match request
$match = $router->match('GET', '/users/123');
if ($match) {
    $handler = $match['handler'];
    $params = $match['params'];       // ['id' => '123']
    $middlewares = $match['middlewares'];
}

Documentation

Full Documentation

• Installation
• Quick Start
• Handlers
• Route Parameters
• Optional Segments
• Route Groups
• Middleware
• Named Routes
• API Reference

Requirements

• PHP 8.1+

License

MIT License. See LICENSE for details.