Routing¶

The RoutingServiceProvider provides a service for generating URLs for named routes.

Parameters¶

route_class: (optional): The default route class used by the route factory (defaults to Mascot\Route).

Services¶

url_generator: An instance of UrlGenerator, using the RouteCollection that is provided through the routes service. It has a generate method, which takes the route name as an argument, followed by an array of route parameters.

Registering¶

$app->register(new Mascot\Provider\RoutingServiceProvider());

Usage¶

The Routing provider provides a url_generator service:

$app->get('/', function () {
    return 'welcome to the homepage';
})
->bind('homepage');

$app->get('/hello/{name}', function ($name) {
    return "Hello $name!";
})
->bind('hello');

$app->get('/navigation', function () use ($app) {
    return '<a href="'.$app['url_generator']->generate('homepage').'">Home</a>'.
           ' | '.
           '<a href="'.$app['url_generator']->generate('hello', array('name' => 'Igor')).'">Hello Igor</a>';
});

When using Twig, the service can be used like this:

{{ app.url_generator.generate('homepage') }}

Moreover, if you have twig-bridge as a Composer dep, you will have access to the path() and url() functions:

{{ path('homepage') }}
{{ url('homepage') }} {# generates the absolute url http://example.org/ #}
{{ path('hello', {name: 'Fabien'}) }}
{{ url('hello', {name: 'Fabien'}) }} {# generates the absolute url http://example.org/hello/Fabien #}

Traits¶

Mascot\Application\UrlGeneratorTrait adds the following shortcuts:

path: Generates a path.
url: Generates an absolute URL.

$app->path('homepage');
$app->url('homepage');