effectra / router
The Effectra HTTP Routing package.
Requires
- bmt/plural-converter: ^1.0
- effectra/http-message: ^1.0
- effectra/http-server-handler: ^2.0
- psr/container: ^2.0
- psr/http-factory: ^1.0
- psr/http-message: ^1.1 || ^2.0
- psr/http-server-handler: ^1.0
- psr/http-server-middleware: ^1.0
README
Effectra PHP Router is a lightweight and flexible routing library for PHP applications. It provides a convenient way to define routes and dispatch incoming requests to the appropriate controllers or callbacks.
Installation
You can install the Effectra PHP Router library via Composer. Run the following command in your project directory:
composer require effectra/router
Usage
To get started with Effectra PHP Router, follow these steps:
- Include the autoloader if you haven't already done so:
require_once 'vendor/autoload.php';
- Import the necessary classes:
use Effectra\Router\Route; use Effectra\Router\RouteGroup; use Effectra\Http\Foundation\RequestFoundation; use Effectra\Http\Message\Response; use Psr\Http\Message\RequestInterface; use Psr\Http\Message\ResponseInterface;
- Create an instance of the
Route
class:
//pass response class to the router $response = new Response(); $route = new Route($response);
- Define routes using the available methods:
$route->get('/home', function () { return 'Welcome to the home page!'; }); $route->post('/contact', 'StaticController@login'); $router->get('/', [HomeController::class, 'index']); $router->get('/users/', [UserController::class, 'index']); $router->post('/signin', function (RequestInterface $request, ResponseInterface $response) { return $response->json([ 'message' => 'hello world' ]); }); $route->crud('/report', ReportController::class, 'read|readOne|create|delete|deleteAll|search'); $route->auth('/auth/', AuthController::class); $route->group('/file/upload/', UploadController::class, function(RouteGroup $router){ $router->post('audio','createAudio'); $router->post('video','createVideo'); });
- Dispatch the incoming request:
$request = RequestFoundation::createFromGlobals(); $route->dispatch($request);
Route Methods
The Route
class provides several methods to define routes:
get($pattern, $callback)
: Defines a GET route.post($pattern, $callback)
: Defines a POST route.put($pattern, $callback)
: Defines a PUT route.delete($pattern, $callback)
: Defines a DELETE route.patch($pattern, $callback)
: Defines a PATCH route.options($pattern, $callback)
: Defines an OPTIONS route.any($pattern, $callback)
: Defines a route that matches any HTTP method.register($method, $pattern, $callback)
: Defines a custom route with a specific HTTP method.routes()
: Returns an array of defined routes.
Middleware
The Route
class supports middleware for route groups. You can use the middleware
method to add middleware to a group of routes:
$router->get('/users/{id}', [UserController::class, 'show'])->middleware(new AuthMiddleware());
Error Handling
The Route
class provides methods to handle 404 Not Found and 500 Internal Server Error responses:
$route->setNotFound(function () { // Handle 404 Not Found response }); $route->setInternalServerError(function () { // Handle 500 Internal Server Error response });
Contributing
Contributions to the Effectra PHP Router library are welcome! If you encounter any issues or have suggestions for improvements, please feel free to open an issue or submit a pull request.
License
The Effectra PHP Router library is open-source software licensed under the MIT license.