{"action":"created","issue":{"url":"https://api.github.com/repos/symfony/symfony-docs/issues/4973","labels_url":"https://api.github.com/repos/symfony/symfony-docs/issues/4973/labels{/name}","comments_url":"https://api.github.com/repos/symfony/symfony-docs/issues/4973/comments","events_url":"https://api.github.com/repos/symfony/symfony-docs/issues/4973/events","html_url":"https://github.com/symfony/symfony-docs/issues/4973","id":56948324,"number":4973,"title":"Document available routing types","user":{"login":"WouterJ","id":749025,"avatar_url":"https://avatars.githubusercontent.com/u/749025?v=3","gravatar_id":"","url":"https://api.github.com/users/WouterJ","html_url":"https://github.com/WouterJ","followers_url":"https://api.github.com/users/WouterJ/followers","following_url":"https://api.github.com/users/WouterJ/following{/other_user}","gists_url":"https://api.github.com/users/WouterJ/gists{/gist_id}","starred_url":"https://api.github.com/users/WouterJ/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/WouterJ/subscriptions","organizations_url":"https://api.github.com/users/WouterJ/orgs","repos_url":"https://api.github.com/users/WouterJ/repos","events_url":"https://api.github.com/users/WouterJ/events{/privacy}","received_events_url":"https://api.github.com/users/WouterJ/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/symfony/symfony-docs/labels/Actionable","name":"Actionable","color":"02e10c"},{"url":"https://api.github.com/repos/symfony/symfony-docs/labels/Easy%20pick","name":"Easy pick","color":"d7e102"},{"url":"https://api.github.com/repos/symfony/symfony-docs/labels/Missing%20Documentation","name":"Missing Documentation","color":"0b02e1"},{"url":"https://api.github.com/repos/symfony/symfony-docs/labels/Routing","name":"Routing","color":"DDDDDD"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-02-08T11:29:01Z","updated_at":"2015-02-08T15:45:53Z","closed_at":null,"body":"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.\r\n\r\nI think this can be added to `book/routing` directly in the [\"Including External Routing Resources\"](http://symfony.com/doc/current/book/routing.html#including-external-routing-resources) section.\r\n\r\n**Available loaders**: yaml, php, xml, annotation (if SensioFrameworkExtraBundle is registered)\r\n\r\n**How loaders are choosen**\r\nWhen 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.\r\n\r\n**The benefit of the type setting**\r\nTypes 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.\r\n\r\n/refs https://github.com/symfony/symfony/issues/13623"},"comment":{"url":"https://api.github.com/repos/symfony/symfony-docs/issues/comments/73416302","html_url":"https://github.com/symfony/symfony-docs/issues/4973#issuecomment-73416302","issue_url":"https://api.github.com/repos/symfony/symfony-docs/issues/4973","id":73416302,"user":{"login":"FusionDev-OpenSource","id":4235601,"avatar_url":"https://avatars.githubusercontent.com/u/4235601?v=3","gravatar_id":"","url":"https://api.github.com/users/FusionDev-OpenSource","html_url":"https://github.com/FusionDev-OpenSource","followers_url":"https://api.github.com/users/FusionDev-OpenSource/followers","following_url":"https://api.github.com/users/FusionDev-OpenSource/following{/other_user}","gists_url":"https://api.github.com/users/FusionDev-OpenSource/gists{/gist_id}","starred_url":"https://api.github.com/users/FusionDev-OpenSource/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/FusionDev-OpenSource/subscriptions","organizations_url":"https://api.github.com/users/FusionDev-OpenSource/orgs","repos_url":"https://api.github.com/users/FusionDev-OpenSource/repos","events_url":"https://api.github.com/users/FusionDev-OpenSource/events{/privacy}","received_events_url":"https://api.github.com/users/FusionDev-OpenSource/received_events","type":"User","site_admin":false},"created_at":"2015-02-08T15:45:53Z","updated_at":"2015-02-08T15:45:53Z","body":"Please add accepted configuration parameters for Routing component. (section You like to know full list of configuration options) "}}