README

Um roteador HTTP moderno, leve e extremamente rápido para PHP 8.1+, construído para trabalhar em harmonia com a biblioteca Codebr HttpFlow.

✨ Características

• Zero dependências externas (além do HttpFlow).
• Suporte a Middlewares (Arquitetura Onion/Pipeline).
• Grupos de Rotas com prefixos e middlewares herdados.
• Parâmetros Dinâmicos via URL (ex: /user/{id}).
• Sintaxe Amigável com suporte a Arrow Functions, Closures e Controllers.
• Normalização de Slashes (ignora se a rota termina com / ou não).

📦 Instalação

O Router requer o PHP 8.1 ou superior. Instale via Composer:

composer require codebr/http-router

<?php

require_once __DIR__ . '/vendor/autoload.php';

use Codebr\HttpRouter\Router;
use Codebr\HttpFlow\Request;
use Codebr\HttpFlow\Response;

$router = new Router();

// Rota simples com Arrow Function
$router->get('/', fn($req, $res) => $res->json(['message' => 'Bem-vindo ao Codebr API']));

// Rota com parâmetros dinâmicos
$router->get('/user/{id}', function(Request $req, Response $res, $id) {
    return $res->json(['user_id' => $id]);
});

$router->run();

// Definindo um Middleware
use Codebr\HttpRouter\Interfaces\MiddlewareInterface;

class AuthMiddleware implements MiddlewareInterface {
    public function handle($request, $response, $next) {
        if (!$request->getHeader('Authorization')) {
            return $response->json(['error' => 'Não autorizado'], 401)->send();
        }
        return $next();
    }
}

// Criando um grupo com prefixo e middleware
$router->group([
    'prefix' => '/api/v1',
    'middlewares' => [AuthMiddleware::class]
], function($router) {
    
    $router->get('/dashboard', function($req, $res) {
        return $res->json(['data' => 'Painel de Controle']);
    });
    
});

$router->post('/products', [ProductController::class, 'store']);

🛠️ Métodos Suportados
O roteador suporta os seguintes verbos HTTP:

$router->get($path, $handler, $middlewares)

$router->post($path, $handler, $middlewares)

$router->put($path, $handler, $middlewares)

$router->patch($path, $handler, $middlewares)

$router->delete($path, $handler, $middlewares)

$router->options($path, $handler, $middlewares)

$router->any($path, $handler, $middlewares) (Responde a todos os métodos)

🏗️ Arquitetura
O projeto segue os princípios de clean code e tipagem forte do PHP 8.1. A execução de middlewares utiliza o padrão de cadeia de responsabilidade (Chain of Responsibility), permitindo interceptar a requisição antes e depois do controlador.

📄 Licença
Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

Feito com ❤️ por [Thiago/Codebr]