# turanmahmudov/phpmicroframework architecture

> Architecture diagram of the GitHub repository turanmahmudov/phpmicroframework, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/turanmahmudov/phpmicroframework
- Repository: https://github.com/turanmahmudov/phpmicroframework

## Overview

##### Main Components

a) Core Framework Components:
- Application Core
- Router System
- Middleware Dispatcher
- Response Emitter
- Container/Factory System

b) Key Architectural Patterns:
- Middleware Pipeline Pattern
- Factory Pattern
- Router Pattern (using FastRoute)

**Top Layer (HTTP Layer):**
- Show incoming HTTP Request
- ResponseEmitter for handling responses

**Middle Layer (Core Framework):**
- Application class as the central component
- MiddlewareDispatcher with pipeline flow
- Router system (FastRoute implementation)

**Bottom Layer (Factory Layer):**
- Container Factory
- Application Factory
- Router Factory
- Middleware Factory

##### Component Relationships

- Bidirectional connections between Application and Router
- Exception handling flow with red lines (showing HTTP exceptions)

##### Specific Implementation Details

- Rectangles: Core components (Application, Router, MiddlewareDispatcher)
- Hexagons: Factories
- Diamonds: Decision points (routing, middleware dispatch)
- Ovals: Entry/Exit points (Request/Response)

- Blue: Core framework components
- Green: HTTP request/response flow
- Yellow: Factory components
- Red: Exception handling components

##### Important Elements to Highlight

a) Middleware System:
- Middleware pipeline structure
- EmptyPipelineHandler as the terminal point
- Middleware dispatch flow

b) Routing System:
- FastRoute integration
- Route collection and dispatch process
- Group routing capabilities

c) Exception Handling:
- Hierarchy of HTTP exceptions
- How exceptions flow through the system

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph HTTP_Layer
        Request(("HTTP Request"))
        ResponseEmitter["Response Emitter"]:::core
    end

    subgraph Core_Framework
        Application["Application Core"]:::core
        
        subgraph Middleware_System
            MiddlewareDispatcher["Middleware Dispatcher"]:::core
            RouterMiddleware["Router Middleware"]:::middleware
            DispatchMiddleware["Dispatch Middleware"]:::middleware
            EmptyPipelineHandler["Empty Pipeline Handler"]:::middleware
        end
        
        subgraph Router_System
            Router["FastRoute Router"]:::core
            RouteCollector["Route Collector"]:::router
            Group["Route Groups"]:::router
            Route["Routes"]:::router
        end
    end

    subgraph Factory_Layer
        AppFactory["Application Factory"]:::factory
        ContainerFactory["Container Factory"]:::factory
        RouterFactory["Router Factory"]:::factory
        MiddlewareFactory["Middleware Factory"]:::factory
    end

    subgraph Exception_Handling
        HttpExceptions["HTTP Exceptions"]:::exception
    end

    %% Flow connections
    Request --> Application
    Application --> MiddlewareDispatcher
    MiddlewareDispatcher --> RouterMiddleware
    RouterMiddleware --> Router
    Router --> DispatchMiddleware
    DispatchMiddleware --> EmptyPipelineHandler
    EmptyPipelineHandler --> ResponseEmitter
    ResponseEmitter --> Request

    %% Router relationships
    Router --> RouteCollector
    RouteCollector --> Group
    RouteCollector --> Route

    %% Factory relationships
    AppFactory -.-> Application
    ContainerFactory -.-> Application
    RouterFactory -.-> Router
    MiddlewareFactory -.-> MiddlewareDispatcher

    %% Exception flow
    HttpExceptions -.-x Application

    %% Styling
    classDef core fill:#3498db,stroke:#2980b9,color:white
    classDef middleware fill:#2ecc71,stroke:#27ae60,color:white
    classDef router fill:#e74c3c,stroke:#c0392b,color:white
    classDef factory fill:#f1c40f,stroke:#f39c12,color:black
    classDef exception fill:#e74c3c,stroke:#c0392b,color:white

    %% Click events
    click Application "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Application.php"
    click Router "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Router/FastRoute/Router.php"
    click MiddlewareDispatcher "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Middleware/MiddlewareDispatcher.php"
    click ResponseEmitter "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/ResponseEmitter.php"
    click ContainerFactory "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Factory/ContainerFactory.php"
    click HttpExceptions "https://github.com/turanmahmudov/PHPMicroFramework/tree/main/src/Http/Exception/"
    click EmptyPipelineHandler "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Middleware/EmptyPipelineHandler.php"
    click RouteCollector "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Router/RouteCollector.php"
    click Group "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Router/Group.php"
    click Route "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Router/Route.php"
    click AppFactory "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Factory/ApplicationFactory.php"
    click MiddlewareFactory "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Factory/MiddlewareDispatcherFactory.php"
    click RouterFactory "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Router/FastRoute/RouterFactory.php"
    click RouterMiddleware "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Router/RouterMiddleware.php"
    click DispatchMiddleware "https://github.com/turanmahmudov/PHPMicroFramework/blob/main/src/Router/DispatchMiddleware.php"
```
