README

PSR-7 & PSR-15 нийцсэн хөнгөн, уян хатан HTTP Application цөм Lightweight, flexible HTTP Application core compliant with PSR-7 & PSR-15

Агуулга / Table of Contents

1. Монгол | 2. English | 3. Getting Started

1. Монгол тайлбар

codesaur/http-application нь PSR-7 (HTTP Message) ба PSR-15 (HTTP Server RequestHandler/Middleware) стандартууд дээр суурилсан минималист, өндөр уян хатан, middleware суурьтай Application цөм юм.

Та хүсвэл:

• Router нэмэх
• Middleware удирдах
• Controller/action ашиглах
• Closure route ашиглах
• Exception handler бүртгэх
• Custom request attributes ашиглах

гэх мэтээр өөрийн хүссэн бүтэцтэй web application-ийг хэдхэн мөр кодоор босгох боломжтой.

Гол боломжууд

• PSR-7 стандартын ServerRequest + Response
• PSR-15 Middleware & RequestHandler гинжин бүтэц
• Уян хатан Router интеграци (codesaur/router)
• Controller суурь класс (MVC хэв маяг дэмжлэг)
• Exception Handler (development mode-той)
• Хэт хөнгөн, хурдан

Дэлгэрэнгүй мэдээлэл

• Бүрэн танилцуулга - Суурилуулалт, хэрэглээ, жишээнүүд
• API тайлбар - Бүх метод, exception-үүдийн тайлбар
• Шалгалтын тайлан - Код шалгалтын тайлан

2. English Description

codesaur/http-application is a minimalist, highly flexible, middleware-based Application core built on PSR-7 (HTTP Message) and PSR-15 (HTTP Server RequestHandler/Middleware) standards.

You can:

• Add Router
• Manage Middleware
• Use Controller/action
• Use Closure routes
• Register Exception handler
• Use Custom request attributes

and build your desired web application structure with just a few lines of code.

Key Features

• PSR-7 Standard ServerRequest + Response
• PSR-15 Middleware & RequestHandler Chain Structure
• Flexible Router Integration (codesaur/router)
• Controller Base Class (MVC pattern support)
• Exception Handler (with development mode)
• Extremely Lightweight and Fast

Documentation

• Full Documentation - Installation, usage, examples
• API Reference - Complete API documentation
• Review - Complete package review and code quality assessment

3. Getting Started

Requirements

• PHP 8.2.1+
• Composer
• PSR-7 compatible HTTP Message implementation (e.g., codesaur/http-message)

Installation

Composer ашиглан суулгана / Install via Composer:

composer require codesaur/http-application

Quick Examples

Application - Basic Setup

use codesaur\Http\Application\Application;
use codesaur\Http\Application\ExceptionHandler;
use codesaur\Http\Message\ServerRequest;

// Application instance үүсгэх / Create Application instance
$app = new Application();

// Exception handler бүртгэх / Register exception handler
$app->use(new ExceptionHandler());

// Route бүртгэх / Register route
$app->GET('/', function ($req) {
    echo 'Hello World!';
});

// Хүсэлт боловсруулах / Handle request
$request = (new ServerRequest())->initFromGlobal();
$response = $app->handle($request);

Router - Dynamic Routes

// Төрөлтэй параметртэй нэртэй route / Named route with typed parameters
$app->GET('/user/{int:id}', [UserController::class, 'show'])->name('user.show');

// Олон method-тэй route / Multi-method route
$app->POST_PUT('/api/users', [UserController::class, 'save']);

// Параметртэй Closure route / Closure route with parameters
$app->GET('/sum/{int:a}/{uint:b}', function ($req) {
    $params = $req->getAttribute('params');
    echo $params['a'] + $params['b'];
});

Controller - MVC Pattern

use codesaur\Http\Application\Controller;

class UserController extends Controller
{
    public function show(int $id): void
    {
        $query = $this->getQueryParams();
        $page = $query['page'] ?? 1;

        echo "User ID: $id, Page: $page";
    }

    public function create(): void
    {
        $data = $this->getParsedBody();
        $name = $data['name'] ?? 'Unknown';

        echo "Created user: $name";
    }
}

Middleware - PSR-15 & Closure

// PSR-15 Middleware
class AuthMiddleware implements MiddlewareInterface
{
    public function process($req, $handler): ResponseInterface
    {
        // Баталгаажуулалт шалгах / Check authentication
        if (!$this->isAuthenticated($req)) {
            return new Response(401);
        }

        return $handler->handle($req);
    }
}

$app->use(new AuthMiddleware());

// Closure Middleware
$app->use(function ($req, $handler) {
    $startTime = microtime(true);
    $response = $handler->handle($req);
    $duration = microtime(true) - $startTime;

    error_log("Request took: {$duration}s");
    return $response;
});

Running Tests

Тест ажиллуулах / Run tests:

# Бүх тестүүдийг ажиллуулах / Run all tests
composer test

# Зөвхөн unit тест / Unit tests only
composer test:unit

# Зөвхөн integration тест / Integration tests only
composer test:integration

# Coverage-тэй тест ажиллуулах / Run tests with coverage
composer test:coverage

Architecture

Application
 +-- Middleware stack (PSR-15 + Closure)
 +-- Router (codesaur/router)
 +-- ExceptionHandler
 +-- Controller / Closure route executor

Request Flow: Application -> Middleware -> Match route -> Controller/action/Closure -> Response

Changelog

• CHANGELOG.md - Full version history

Contributing & Security

• Contributing Guide
• Security Policy

License

This project is licensed under the MIT License.

Author

Narankhuu
codesaur@gmail.com
https://github.com/codesaur

codesaur ecosystem: https://codesaur.net