rc router
Added the ability to write your own parsers
This is rc router. This is a simple regex based router that allows you to pass variables by using place holders in your route.
I did it to flex my brain, and get a full understanding of how routing works in the PHP space. Rather than just reading about it and assuming I knew what did what, I wrote this to solidify my knowledge.
Simply use composer:
composer require robert430404/rc-router
This is a composer package so it relies on composer for the autoloading of the classes. You then create a new instance of the Router() object and start assigning your routes to the instance. Once you have your routes defined, you then pass the Router() into the Resolver() and it handles your routes.
<?php
use RcRouterRouter;
use RcRouterUtilitiesResolver;
use RcRouterExceptionsRouteNotFoundException;
include 'vendor/autoload.php';
$router = new Router();
$router->request(['GET'], '/', function () {
echo 'Closure Handler Test';
});
$uri = $_SERVER['REQUEST_URI']; // You do not have to use globals here if you have access to a different source.
$method = $_SERVER['REQUEST_METHOD']; // You simply need to pass these (uri and method) as strings to the Resolver.
try {
new Resolver($uri, $method, $router);
} catch (RouteNotFoundException $e) {
echo '404 not found';
}The router supports both string and integer url variables, and passes them back to you in an array. You can extend this further in any way you want. The router is very flexible in how you can use it.
You can either pass in a closure, or a named handler function to each route to control what happens when a route is matched.
When a route is not found, a RouteNotFoundException is thrown from the resolver and allows you to catch and then create your 404 handler.
You can also now write in your own custom parsers and pass them into the resolver to make things like Controller@Action calling a lot easier and cleaner to implement.
<?php
use RcRouterRouter;
use RcRouterUtilitiesResolver;
use RcRouterExceptionsRouteNotFoundException;
use YourProjectRoutingCustomParser;
include 'vendor/autoload.php';
$router = new Router();
$router->request(['GET'], '/', function () {
echo 'Closure Handler Test';
});
$uri = $_SERVER['REQUEST_URI']; // You do not have to use globals here if you have access to a different source.
$method = $_SERVER['REQUEST_METHOD']; // You simply need to pass these (uri and method) as strings to the Resolver.
try {
new Resolver($uri, $method, $router, new CustomParser());
} catch (RouteNotFoundException $e) {
echo '404 not found';
}If you don't pass a cusom parser, it defaults to the built in parser.
When there are placeholders in your route they are returned to you as an array that you can access in your handler.
You have access to string placeholders. When you define your routes, you use {} to define string placeholders like this:
<?php
$router->request(['GET'], '/{placeholder}', function ($mapped) {
// Deal with returned data and route response here.
});You also have access to integer placeholders. When you define your route, you use {:i} to define integer placeholders like this:
<?php
$router->request(['GET'], '/{placeholder:i}', function ($mapped) {
// Deal with returned data and route response here.
});Simple closure based route:
<?php
use RcRouterRouter;
use RcRouterUtilitiesResolver;
use RcRouterExceptionsRouteNotFoundException;
include 'vendor/autoload.php';
$router = new Router();
$router->request(['GET'], '/', function () {
echo 'Closure Handler Test';
});
$uri = $_SERVER['REQUEST_URI']; // You do not have to use globals here if you have access to a different source.
$method = $_SERVER['REQUEST_METHOD']; // You simply need to pass these (uri and method) as strings to the Resolver.
try {
new Resolver($uri, $method, $router);
} catch (RouteNotFoundException $e) {
echo '404 not found';
}Simple route with a named handler:
<?php
use RcRouterRouter;
use RcRouterUtilitiesResolver;
use RcRouterExceptionsRouteNotFoundException;
include 'vendor/autoload.php';
$router = new Router();
$router->request(['GET'], '/', 'handler');
$uri = $_SERVER['REQUEST_URI']; // You do not have to use globals here if you have access to a different source.
$method = $_SERVER['REQUEST_METHOD']; // You simply need to pass these (uri and method) as strings to the Resolver.
try {
new Resolver($uri, $method, $router);
} catch (RouteNotFoundException $e) {
echo '404 not found';
}
function handler()
{
echo 'External Handler Test';
}Regex closure based route with variables:
<?php
use RcRouterRouter;
use RcRouterUtilitiesResolver;
use RcRouterExceptionsRouteNotFoundException;
include 'vendor/autoload.php';
$router = new Router();
$router->request(['GET'], '/{id:i}/{post:i}', function ($mapped) {
echo '<pre>';
var_dump($mapped);
echo '</pre>';
echo 'Route Found';
});
$uri = $_SERVER['REQUEST_URI']; // You do not have to use globals here if you have access to a different source.
$method = $_SERVER['REQUEST_METHOD']; // You simply need to pass these (uri and method) as strings to the Resolver.
try {
new Resolver($uri, $method, $router);
} catch (RouteNotFoundException $e) {
echo '404 not found';
}Regex route with variables and external handler:
<?php
use RcRouterRouter;
use RcRouterUtilitiesResolver;
use RcRouterExceptionsRouteNotFoundException;
include 'vendor/autoload.php';
$router = new Router();
$router->request(['GET'], '/{id:i}/{post:i}', 'handler');
$uri = $_SERVER['REQUEST_URI']; // You do not have to use globals here if you have access to a different source.
$method = $_SERVER['REQUEST_METHOD']; // You simply need to pass these (uri and method) as strings to the Resolver.
try {
new Resolver($uri, $method, $router);
} catch (RouteNotFoundException $e) {
echo '404 not found';
}
function handler($mapped)
{
echo '<pre>';
var_dump($mapped);
echo '</pre>';
echo 'Route Found';
}The "$mapped" variable returns a structure like this:
<?php
$mapped = [
'all' => [
'id' => 0,
'name' => 'Robert'
],
'int' => [
'id' => 0
],
'string' => [
'name' => 'Robert'
],
];
