# 8ctopus/nano-router architecture

> Architecture diagram of the GitHub repository 8ctopus/nano-router, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/8ctopus/nano-router
- Repository: https://github.com/8ctopus/nano-router

## Overview

##### Component Relationships

**HTTP Request → PSR-17 Factory → NanoRouter → Route Handler → Response → Emitter → Client**

**Pre-Middleware → Route Processing → Post-Middleware**

##### Detailed Components

a) Core Classes (Rectangles):
- NanoRouter (Central component)
- AbstractRoute
- Route
- RouteAlias
- Middleware

b) Supporting Elements (Rounded Rectangles):
- PSR-7 Request/Response
- PSR-17 Factories
- Error Handlers

c) Enums/Types (Hexagons):
- RouteType (Exact, StartsWith, Regex)
- MiddlewareType (Pre, Post)

##### Implementation Details

Notes for important implementation details:
- No external dependencies besides PSR-7/17
- Performance metrics (<2ms routing time)
- Support for different route types
- Exception handling capabilities

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph HTTP_Layer
        Request[HTTP Request]
        PSR7["PSR-7 Server Request"]:::psr
        Emitter["Response Emitter (SapiEmitter)"]
    end

    subgraph Router_Core
        NanoRouter["NanoRouter"]:::core
        AbstractRoute["AbstractRoute"]:::core
        Route["Route"]:::core
        RouteAlias["RouteAlias"]:::core
        Middleware["Middleware"]:::middleware
    end

    subgraph Route_Types
        RouteType["RouteType Enum<br/>(Exact, StartsWith, Regex)"]:::enum
        MiddlewareType["MiddlewareType Enum<br/>(Pre, Post)"]:::enum
    end

    subgraph Exception_Handling
        NanoRouterException["NanoRouterException"]:::error
        RouteException["RouteException"]:::error
    end

    subgraph Route_Handlers
        RouteDefinitions["Route Definitions"]
        ErrorHandlers["Error Handlers"]:::error
        MiddlewareHandlers["Middleware Handlers"]:::middleware
    end

    Request --> PSR7
    PSR7 --> NanoRouter
    NanoRouter --> Route
    Route --> RouteDefinitions
    RouteDefinitions --> Emitter
    
    AbstractRoute --> Route
    AbstractRoute --> RouteAlias
    
    NanoRouter --> Middleware
    Middleware --> MiddlewareHandlers
    
    RouteType --> Route
    MiddlewareType --> Middleware
    
    Route --> NanoRouterException
    Route --> RouteException
    
    %% Click events for component mapping
    click NanoRouter "https://github.com/8ctopus/nano-router/blob/master/src/NanoRouter.php"
    click AbstractRoute "https://github.com/8ctopus/nano-router/blob/master/src/AbstractRoute.php"
    click Route "https://github.com/8ctopus/nano-router/blob/master/src/Route.php"
    click RouteAlias "https://github.com/8ctopus/nano-router/blob/master/src/RouteAlias.php"
    click Middleware "https://github.com/8ctopus/nano-router/blob/master/src/Middleware.php"
    click RouteType "https://github.com/8ctopus/nano-router/blob/master/src/RouteType.php"
    click MiddlewareType "https://github.com/8ctopus/nano-router/blob/master/src/MiddlewareType.php"
    click NanoRouterException "https://github.com/8ctopus/nano-router/blob/master/src/NanoRouterException.php"
    click RouteException "https://github.com/8ctopus/nano-router/blob/master/src/RouteException.php"
    
    %% Styling
    classDef core fill:#2374e1,color:white
    classDef middleware fill:#4CAF50,color:white
    classDef error fill:#FFA726,color:black
    classDef enum fill:#9C27B0,color:white
    classDef psr fill:#78909C,color:white
    
    %% Legend
    subgraph Legend
        L1["Core Components"]:::core
        L2["Middleware Components"]:::middleware
        L3["Exception Handling"]:::error
        L4["Enums/Types"]:::enum
        L5["PSR Interfaces"]:::psr
    end
```
