Document available routing types

[wouterj]

We seem to have no documentation on the available routing loader types that you configure when loading a resource in app/config/routing.yml. Nor do we document how Symfony determines the loader when no type is used and what the benefit of the type setting is. I've seem a couple of people asking for such docs the last weeks.

I think this can be added to book/routing directly in the "Including External Routing Resources" section.

Available loaders: yaml, php, xml, annotation (if SensioFrameworkExtraBundle is registered)

How loaders are choosen
When no type is configured, it's based on the extension. The first matching loader will be used. When a type is configured, both extension and type are taken into account. For instance, a file custom_routing.yml with type yaml will be loaded by the yaml loader, while a custom_routing.php with type yaml will not be loaded, as no loader matches both the .php extension and the yaml type.

The benefit of the type setting
Types allow you to use different loaders for the same extension, for instance a .php extension can be loaded by both the PHP and the annotation loader. Using the type annotation will make sure it's loaded by the annotation loader.

/refs symfony/symfony#13623

Please add accepted configuration parameters for Routing component. (section You like to know full list of configuration options)

[wouterj]

What more do you expect to be documented?

I just dont know if there are more config options available for Routing. Im new to symfony, but im curious. Thanks

[wouterj]

You can only configure routes or import resources. Both are explained in detail in the Routing book article, the type details were the only things missing.

There are some global configuration settings for the routing component which are documented in the FrameworkBundle configuration reference.

You mean this? http://symfony.com/doc/current/reference/configuration/framework.html

Yes the global config are the ones I didnt find.

[wouterj]

Ah, in that case: They'll be added to that article very soon. We've rewritten the complete FrameworkBundle config reference to document every available config option: #4736

[LS05]

What's the status of this issue?
Would like to solve it. Any suggestions?
Thank you :)

[javiereguiluz]

We could document this ... but let's do it very briefly. I don't think there's much to say because Symfony's behaviour here is simple, right?

[osavchenko]

But you can find all information about formats in the doc:
Creating routes - about different formats and how to use annotations and External resources with additional information.