anax / router
Anax Router module, route requests to handlers.
Installs: 17 661
Dependents: 19
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 1
Open Issues: 0
Requires
- php: >=7.2
- anax/commons: ^2.0.0@alpha
- psr/container: ^1.0
Requires (Dev)
- anax/configure: ^2.0.0@alpha
- anax/di: ^2.0.0@alpha
- phpunit/phpunit: ^8
- dev-master
- v2.1.0
- v2.0.1
- v2.0.0
- v2.0.0-beta.9
- v2.0.0-beta.8
- v2.0.0-beta.7
- v2.0.0-beta.6
- v2.0.0-beta.5
- v2.0.0-beta.4
- v2.0.0-beta.3
- v2.0.0-beta.2
- v2.0.0-beta.1
- v2.0.0-alpha.14
- v2.0.0-alpha.13
- v2.0.0-alpha.12
- v2.0.0-alpha.11
- v2.0.0-alpha.10
- v2.0.0-alpha.9
- v2.0.0-alpha.8
- v2.0.0-alpha.7
- v2.0.0-alpha.6
- v2.0.0-alpha.5
- v2.0.0-alpha.4
- v2.0.0-alpha.3
- v2.0.0-alpha.2
- v2.0.0-alpha.1
- v1.1.0
- v1.0.15
- v1.0.14
- v1.0.13
- v1.0.12
- v1.0.11
- v1.0.10
- v1.0.9
- v1.0.8
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0.0
This package is auto-updated.
Last update: 2024-10-19 19:31:20 UTC
README
Anax Router module.
A standalone router supporting request methods and dynamic routes matching, extracting and validating arguments from path.
The router will try matching routes by the order they were added and execute all matching routes, one after the other.
Use exit()
to prevent further routes from being matched.
Install
$ composer require anax/router
Usage
Add some routes with handlers
use Anax\Route\Router; $router = new Router(); $router->add("", function () { echo "home "; }); $router->add("about", function () { echo "about "; }); $router->add("about/me", function () { echo "about/me "; }); // try it out $router->handle(""); $router->handle("about"); $router->handle("about/me"); // home about about/me
Add multiple routes with one handler
Add multiple routes, through an array of rules, sharing a handler.
$router = new Router(); $router->add(["info", "about"], function () { echo "info or about - "; }); // try it out $router->handle("info"); $router->handle("about"); // info or about - info or about -
Add a default route
This route will match any path.
$router = new Router(); $router->always(function () { echo "always "; }); // try it out using some paths $router->handle("info"); $router->handle("about"); // always always
Add internal routes for 404, 403 and 500 error handling
Add an internal route that is called when no route can be matched.
$router = new Router(); $router->addInternal("404", function () { echo "404 "; }); $router->add("about", function () { echo "about "; }); // try it out using some paths $router->handle("whatever"); // 404
You can add internal routes to deal with 403 and 500. These routes will handle uncaught exceptions thrown within a route handler.
The 403 internal route that is catching exception of type ForbiddenException
.
$router->addInternal("403", function () { echo "403 "; }); $router->add("login", function () { throw new ForbiddenException(); }); // try it out using some paths $router->handle("login"); // 403
The 500 internal route that is catching exception of type InternalErrorException
.
$router->addInternal("500", function () { echo "500 "; }); $router->add("calculate", function () { throw new InternalErrorException(); }); // try it out using some paths $router->handle("calculate"); // 500
Add a common route for any item below subpath using *
This route will match any item on the same level as about/*
.
$router = new Router(); $router->addInternal("404", function () { echo "404 "; }); $router->add("about/*", function () { echo "about "; }); // try it out using some paths $router->handle("about"); $router->handle("about/me"); $router->handle("about/you"); $router->handle("about/some/other"); // no match // about about about 404
Add a common route for any item below subpath using **
This route will match any item below about/**
, even subdirs.
$router = new Router(); $router->add("about/**", function () { echo "about "; }); // try it out using some paths $router->handle("about"); $router->handle("about/me"); $router->handle("about/you"); $router->handle("about/some/other"); // about about about about
Part of path as arguments to the route handler
You can send a part of the route as an argument to the handler. This makes a route handler more flexible and dynamic.
$router = new Router(); $router->addInternal("404", function () { echo "404 "; }); $router->add("about/{arg}", function ($arg) { echo "$arg "; }); ob_start(); // try it out using some paths $router->handle("about"); // not matched $router->handle("about/me"); $router->handle("about/you"); $router->handle("about/some/other"); // not matched // 404 me you 404
You can send multiple arguments.
$router = new Router(); $router->add( "post/{year}/{month}/{day}", function ($year, $month, $day) { echo "$year-$month-$day, "; } ); // try it out using some paths $router->handle("post/2017/03/07"); $router->handle("post/1990/06/20"); // 2017-03-07, 1990-06-20,
Type checking of arguments
Apply type checking to the arguments to restrict a the routes being matched.
$router = new Router(); $router->addInternal("404", function () { echo "404, "; }); $router->add( "post/{year:digit}/{month:digit}/{day:digit}", function ($year, $month, $day) { echo "$year-$month-$day, "; } ); $router->add( "post/{year:digit}/{month:alpha}/{day:digit}", function ($year, $month, $day) { echo "$day $month $year, "; } ); // try it out using some paths $router->handle("post/2017/03/seven"); $router->handle("post/2017/03/07"); $router->handle("post/1990/06/20"); $router->handle("post/1990/june/20"); // 404, 2017-03-07, 1990-06-20, 20 june 1990,
For type checking is digit, alpha, alphanum and hex supported (see ctype for details).
Routes per request method
A route can be setup to match only one request method.
$router = new Router(); $router->any(["GET"], "about", function () { echo "GET "; }); $router->any(["POST"], "about", function () { echo "POST "; }); $router->any(["PUT"], "about", function () { echo "PUT "; }); $router->any(["DELETE"], "about", function () { echo "DELETE "; }); // try it out using some paths $router->handle("about", "GET"); $router->handle("about", "POST"); $router->handle("about", "PUT"); $router->handle("about", "DELETE"); // GET POST PUT DELETE
A route can also match several request methods.
$router = new Router(); $router->any(["GET", "POST"], "about", function () { echo "GET+POST "; }); $router->any("PUT | DELETE", "about", function () { echo "PUT+DELETE "; }); // try it out using some paths $router->handle("about", "GET"); $router->handle("about", "POST"); $router->handle("about", "PUT"); $router->handle("about", "DELETE"); // GET+POST GET+POST PUT+DELETE PUT+DELETE
Dependency
These are the dependencies to other modules.
License
This software carries a MIT license. See LICENSE.txt for details.
.
..: Copyright (c) 2013 - 2019 Mikael Roos, mos@dbwebb.se