Wallogit.com
2017 © Pedro Peláez
Probably the smallest fully featured PHP Router for web applications ever built
, (*1)
The PHPico Router is probably the smallest fully featured PHP Router for web applications ever built., (*2)
It's intended for use with light applications. Even for embbeded uses like Raspberrypi., (*3)
Disclaimer: This class could be very useful for absolute noobs. You could learn A LOT just seeing this library code. Model View Controller is totally encouraged and is piece of cake if you know how to use this router. I promise, just one class, just a few lines (Less than 100)., (*4)
The next example shows what you can do with this router., (*5)
<?php
include('../vendor/autoload.php');
class HomeController{
function index(){
return 'Hello people';
}
function greet($a){
return 'Hello '.$a;
}
}
$routes = [
'\/greet\/(.*)' => ['POST', function(){
return "Oh yeah callbacks :D";
}],
'\/greet\/(.*)' => ['GET', 'HomeController@greet'],
'\/' => 'HomeController'
];
$router = new \PHPico\Router();
echo($router->dispatch($routes));
You can use PCRE. The only rule is that any REGEXP is launched
as if it has /^.......$/ so you don't need to add the first/end
delimiter and the first/end slashes., (*6)
There are multiple ways to create a route. But the basic one is this:, (*7)
<?php
$routes = [
'\/' => 'HomeController'
];
HomeController is an example class in the main namespace.
You should add the namespaces if there are any.
If you have newer PHP versions you could use php HomeController::class, (*8)
You can use any callable to be used as destination. For example this anonymous function:, (*9)
<?php
$routes = [
'\/greet\/(.*)' => function($a){
return "Hello ".$a;
},
];
As you can see you can add params in order to get the capture of the REGEXP.
(.*) Means capture any character, zero or more times.
Then just add the $a var to recover this capture., (*10)
By default any route unless specified will allow any type of request. But you can segment the route for one or more specific requests. For example:, (*11)
<?php
$routes = [
'\/' => ['POST','HomeController']
];
This means that any request to the / path will return false unless you make a POST request., (*12)
You can even add more than one option, like:, (*13)
<?php
$routes = [
'\/' => ['GET', 'POST','HomeController']
];
The router component will return false if the route is not found. Simple and effective., (*14)
<?php
if($router->dispatch($routes) === false){
header("HTTP/1.0 404 Not Found");
die('Not found');
}
If you have any idea of how to improve this library you're welcome to submit a pull request with your improvement or fix. Remember that the idea is to keep the codebase the smallest possible., (*15)
Probably the smallest fully featured PHP Router for web applications ever built
MIT
router
Probably the smallest fully featured PHP Router for web applications ever built
MIT
router