switon/router

Attribute-discovered routes, route tables, and literal and dynamic path matching for Switon Framework

v1.0.0 2026-06-06 13:43 UTC

Requires

• php: >=8.3
• psr/event-dispatcher: ^1.0
• switon/command: ^1.0
• switon/console: ^1.0
• switon/core: ^1.0
• switon/event: ^1.0

Requires (Dev)

• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• switon/testing: ^1.0

MIT

• switon

• routing
• router
• paths
• switon

README

Switon's route matcher for literal and dynamic paths, attribute discovery, prefix-aware matching, and route resolution events.

Highlights

• Attribute-based routing: controllers and actions declare routes in place with #[RequestMapping] and method mappings.
• Prefix-aware discovery: controller prefixes can be derived from names or set explicitly.
• Path mapping rules: '', relative, absolute, and array paths all map cleanly to routes.
• View mappings: #[ViewGetMapping] and related attributes can add GET views beside write actions.
• Fast route lookup: literal routes stay in hash lookups while dynamic ones compile to regex.
• Match visibility: RouteNotFound and RouteParamsResolved expose misses and parameter resolution.

Installation

composer require switon/router

Quick Start

use Switon\Routing\Attribute\GetMapping;
use Switon\Routing\Attribute\RequestMapping;

#[RequestMapping('/user')]
class UserController
{
    #[GetMapping('{id}')]
    public function showAction(int $id): array
    {
        return ['id' => $id];
    }
}

Docs: https://docs.switon.dev/latest/router

License

MIT.