krubio / perfect-router
A Perfect Router
Requires
- krubio/perfect-container: ^1.1
Requires (Dev)
- phpunit/phpunit: ^11
This package is auto-updated.
Last update: 2024-12-02 20:27:56 UTC
README
PerfectRouter
Description
PerfectRouter is a PHP routing library that provides a simple and efficient way to handle HTTP requests in your web application. It allows developers to define routes using attributes and automatically register controllers and their methods as route handlers. PerfectRouter works seamlessly with PerfectContainer to manage dependencies and create controller instances.
Features
- Attribute-Based Routing: Define routes directly in controller methods using PHP 8 attributes.
- Auto-Registration: Automatically register controllers and their routes from a specified directory.
- Dynamic Route Parameters: Capture dynamic parameters directly from the URL.
- HTTP Method Handling: Define routes for specific HTTP methods (GET, POST, etc.)
- Custom 404 Handling: Easily customize 404 Not Found responses.
Installation
Use Composer to install the PerfectRouter library.
composer require krubio/perfect-router
Examples
You can find examples in the examples
directory of the project. Run composer install
from the examples
directory to install the required dependencies.
cd examples
composer install
Usage
Here's a basic usage example of PerfectRouter:
<?php declare(strict_types=1); require_once './vendor/autoload.php'; use PerfectApp\Container\Container; use PerfectApp\Logger\FileLogger; use PerfectApp\Routing\Router; $logger = new FileLogger('errors.log'); $container = new Container(); $router = new Router($container); $router->autoRegisterControllers(__DIR__ . '/src/Controllers'); // A user-defined exception handler function $router->setNotFoundHandler(function ($requestUri, $requestMethod) use ($logger) { $logger->error("Route $requestUri with method $requestMethod not found."); http_response_code(404); echo "Route $requestUri with method $requestMethod not found."; }); try { $router->dispatch($_SERVER['REQUEST_URI'], $_SERVER['REQUEST_METHOD']); } catch (RuntimeException $e) { $logger->error($e->getMessage()); http_response_code(404); echo "Route not found."; }
Contributing
Contributions, issues, and feature requests are welcome!
License
This project is MIT licensed.