Solo RouterHigh-Performance PHP Router

Middleware support, route groups, named routes, and advanced optional segment patterns.

Get Started

View on GitHub

⚡

High Performance

Static routes use O(1) hash lookup. Pattern caching for compiled regex.

🔗

Fluent API

Chainable ->name() and ->middleware() methods for clean route definitions.

📦

Route Groups

Shared prefixes and middleware with nested group support.

🛡️

Middleware

Single and multiple middleware per route or group.

🎯

Advanced Patterns

Optional segments in any position, nested optionals, regex constraints.

🏷️

Named Routes

Easy route referencing by name for URL generation.

Quick Example

php

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'];
}

Installation

bash

composer require solophp/router

Requirements: PHP 8.1+