spiffy/spiffy-route

Spiffy\Route is a light-weight, HHVM compatible, and dependency free router library.

Spiffy\Route

, _(*1)

Installation

Spiffy\Route can be installed using composer which will setup any autoloading for you., _(*2)

composer require spiffy/spiffy-route, _(*3)

Additionally, you can download or clone the repository and setup your own autoloading., _(*4)

Adding routes

use Spiffy\Route\Router;

$router = new Router();

// Basic route with name
$router->add('foo', '/foo');
// matches /foo

// Basic route with no name
$router->add(null, '/foo');
// matches /foo

// Route with tokens
$router->add('foo', '/foo/{name}');
// matches /foo/bar

// Router with optional tokens
$router->add('foo', '/foo{/name?}');
// matches /foo or /foo/bar

// Router with tokens and constraints
$router->add('foo', '/foo/{id:\d+}-{slug}');
// matches /foo/1-bar but not /foo/baz-bar

// The kitchen sink
$router->add('foo', '/foo/{id:\d+}{-slug?:[a-zA-Z-_]+}');
// matches /foo/1, /foo/1-bar, /foo/1-BaR
// does not match /foo/1-2

Assembling named routes to url's

use Spiffy\Route\Router;

$router = new Router();
$router->add('foo', '/foo');

// outputs '/foo'
echo $router->assemble('foo');

$router->add('foo', '/foo/{id:\d+}{-slug?:[a-zA-Z-_]+}');

// outputs '/foo/1'
echo $router->assemble('foo', ['id' => 1]);

// outputs '/foo/1-bar'
echo $router->assemble('foo', ['id' => 1, 'slug' => 'bar']);

Matching routes

use Spiffy\Route\Router;

$router = new Router();
$router->add('foo', '/foo');

// result is NULL
echo $router->match('/bar');

// result is an instance of Spiffy\Route\RouteMatch
$match = $router->match('/foo');

// output is 'foo'
echo $match->getName();

$router->add('bar', '/bar/{id}');

// result is an instance of Spiffy\Route\RouteMatch
$match = $router->match('/bar/1');

// output is 'bar'
echo $match->getName();

// output is '1'
echo $match->get('id');

// you can also have defaults for params that may not exist (output is 'foo')
echo $match->get('does-not-exist', 'foo');

Default route parameters

```php use Spiffy\Route\Router;, <sub>(*5)</sub>

$router = new Router(); $router->add('foo', '/foo{/id?}', ['defaults' => ['id' => 1, 'controller' => 'foo-controller']]);, <sub>(*6)</sub>

$match = $router->match('/foo/1234');, <sub>(*7)</sub>

// output is '1234' echo $match->get('id');, <sub>(*8)</sub>

$match = $router->match('/foo');, <sub>(*9)</sub>

// output is '1' echo $match->get('id');, <sub>(*10)</sub>

// output is 'foo-controller' echo $match->get('controller');, <sub>(*11)</sub>