packfire/router

URL routing, easier.

Packfire Router

, _(*1)

Fast & clean URL router for PHP 5.3+., _(*2)

• No-frills URL to callback routing
• Fast route dispatch through effective OOP design
• Scalable and expansive API

Installing

Use Composer to install "packfire/router": "1.0.*"., _(*3)

1. Download composer.phar
2. Add "packfire/router": "1.0.*" under the "require" configuration in composer.json.
3. Run php composer.phar install to install Packfire Router.

Loading Routes from Config

Simply load your routes from any configuration format you like:, _(*4)

use Packfire\Router\FileLoader;

$loader = new FileLoader('config/routes.yml'); // loading from a YAML file
$loader = new FileLoader('config/routes.json'); // loading from a JSON file
$loader = new FileLoader('config/routes.php'); // or loading from a PHP file that returns an array of configuration

// create the Router object using the configuration
$router = $loader->load();

A sample configuration looks like this (in YAML):, _(*5)

routes:
  home:
    path: /
    method: get
    action: HeartCode\Blog\Controller::index
  post:
    path: /post/:id-:title
    method: get
    params:
      id: i
      title: slug
    action: HeartCode\Blog\Controller:view

Routing Requests

Routing requests is simple:, _(*6)

use Packfire\Router\FileLoader;
use Packfire\Router\CurrentRequest;

$loader = new FileLoader('config/routes.yml');
$router = $loader->load();

// load data from $_SERVER
$request = new CurrentRequest();

// Get the route based on the current request
$route = $router->route($request);

With the $route object in hand, you can easily execute the $route by simply running the callback:, _(*7)

// performs the action that the route needs to
$route->callback();

Generating URLs from Routes

You can perform reverse engineering by putting the route and parameters to form its full working URL:, _(*8)

use Packfire\Router\FileLoader;    

$loader = new FileLoader('config/routes.yml');
$router = $loader->load();

$url = $router->generate('post', array('id' => 412, 'title' => 'maybe-this-works'));

$url will probably equals to /post/412-maybe-this-works, _(*9)