RoutingBundle

The RoutingBundle integrates dynamic routing into Symfony using the CMF Routing component . See the component documentation if you are interested in the implementation details of the services explained in this chapter.

The ChainRouter is meant to replace the default Symfony Router. All it does is manage a prioritized list of routers and try to match requests and generate URLs with all of them. One of the routers in that chain can of course be the default router so you can still use the Symfony standard way of specifying routes where it makes sense.

Additionally, this bundle delivers useful router implementations. It provides the DynamicRouter that routes based on a custom loader logic for Symfony Route objects. The provider can be implemented using a database. This bundle provides default implementations for Doctrine PHPCR-ODM and Doctrine ORM.

The DynamicRouter service is only made available when explicitly enabled in the application configuration.

Finally this bundles provides route documents for Doctrine PHPCR-ODM and ORM, as well as a controller for redirection routes.

1
2
3
4
5
6

# app/config/services.yaml
services:
    app.my_router:
        class: AppBundle\Routing\MyRouter
        tags:
            - { name: router, priority: 300 }

1
2
3
4

<!-- app/config/services.xml -->
<service id="app.my_router" class="AppBundle\Routing\MyRouter">
    <tag name="router" priority="300" />
</service>

1
2
3
4
5
6
7

# app/config/services.php
use AppBundle\Routing\MyRouter;

$container
    ->register('app.my_router', MyRouter::class)
    ->addTag('router', ['priority' => 300])
;