Wallogit.com
2017 © Pedro Peláez
Simple PHP Router, with prefix groups and filtering
Simple PHP router with prefix grouping and filters, (*1)
This README file is a work in progress and is in the process of being written. In the meantime, please refer to the examples folder to get started., (*2)
Please refer to the examples folder to see how to use the router, along with usage of grouping and filters., (*3)
From the command line:, (*4)
composer require alejoluc/via, (*5)
Or write manually in composer.json:, (*6)
{
"require": {
"alejoluc/via": "*"
}
}
A "Facade" is provided for those that want clearer code and don't mind using static classes here and there. You can use any method of the Router class when calling the Facade., (*7)
<?php
use alejoluc\Via\RouterFacade as Router;
// [Set up Router (see file in examples)
Router::get('login', ['LoginController', 'showForm']);
Router::group('admin/', function(){
Router::get('createUser', ['UsersController', 'createForm']);
}, ['isLoggedIn']);
There are three possible scenarios when calling the dispatch() method: no route will match, or a route will match but some or all filters will fail, or a route will match and no filter fails., (*8)
In all cases, a Match object is passed to whatever match handler or handlers you have set up. You can see the src/SampleHandlers/ folder for several comprehensive handlers., (*9)
If no request string is manually specified, the router will try to get it automatically from $_SERVER['REQUEST_URI'] or $_SERVER['PATH_INFO']. Aditionally, it will truncate the script file name from the request string, if it is there, and it will also truncate the query string (anything after ? or &), if it exists. This will not happen if you manually set the request string via Router::setRequestString(), (*10)
As a general rule, you should manually call Router::setRequestString() only when you know what you are doing and why, and let the router do the dirty work the rest of the time., (*11)
For example, if you have no url rewriting in place in your server, you might still want to use the router and you can do it by placing the routes in a query variable, like q. An example for that approach, assuming the file name is index.php, would be:, (*12)
<?php
use alejoluc\Router\Router;
$router = new Router();
$q = isset($_GET['q']) ? $_GET['q'] : '/';
$router->setRequestString($q);
$router->get('/about', 'About Page'); // Will respond to /index.php?q=/about
Simple PHP Router, with prefix groups and filtering
MIT
routing router
Simple PHP Router, with prefix groups and filtering
MIT
routing router