packfire/router

This package is abandoned and no longer maintained. No replacement package was suggested.

URL routing, easier.

1.1.1 2014-03-05 22:44 UTC

Requires

• php: >=5.3.0
• packfire/config: 1.2.*
• packfire/fuelblade: 1.2.*

BSD-3-Clause

• Sam-Mauris Yong

README

#Packfire Router

Fast & clean URL router for PHP 5.3+.

• 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.*".

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:

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):

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:

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:

// 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:

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