RouteCollectionBuilder
class RouteCollectionBuilder
Helps add and import routes into a RouteCollection.
Methods
| __construct(LoaderInterface $loader = null) | ||
| RouteCollectionBuilder | import(mixed $resource, string|null $prefix = '/', string $type = null) Import an external routing resource and returns the RouteCollectionBuilder. | |
| Route | add(string $path, string $controller, string|null $name = null) Adds a route and returns it for future modification. | |
| RouteCollectionBuilder | createBuilder() Returns a RouteCollectionBuilder that can be configured and then added with mount(). | |
| mount(string $prefix, RouteCollectionBuilder $builder) Add a RouteCollectionBuilder. | ||
| $this | addRoute(Route $route, string|null $name = null) Adds a Route object to the builder. | |
| $this | setHost(string $pattern) Sets the host on all embedded routes (unless already set). | |
| $this | setCondition(string $condition) Sets a condition on all embedded routes (unless already set). | |
| $this | setDefault(string $key, mixed $value) Sets a default value that will be added to all embedded routes (unless that default value is already set). | |
| $this | setRequirement(string $key, mixed $regex) Sets a requirement that will be added to all embedded routes (unless that requirement is already set). | |
| $this | setOption(string $key, mixed $value) Sets an option that will be added to all embedded routes (unless that option is already set). | |
| $this | setSchemes(array|string $schemes) Sets the schemes on all embedded routes (unless already set). | |
| $this | setMethods(array|string $methods) Sets the methods on all embedded routes (unless already set). | |
| RouteCollection | build() Creates the final RouteCollection and returns it. | 
Details
__construct(LoaderInterface $loader = null)
Parameters
| LoaderInterface | $loader | 
RouteCollectionBuilder import(mixed $resource, string|null $prefix = '/', string $type = null)
Import an external routing resource and returns the RouteCollectionBuilder.
$routes->import('blog.yml', '/blog');
Parameters
| mixed | $resource | |
| string|null | $prefix | |
| string | $type | 
Return Value
| RouteCollectionBuilder | 
Exceptions
| FileLoaderLoadException | 
Route add(string $path, string $controller, string|null $name = null)
Adds a route and returns it for future modification.
Parameters
| string | $path | The route path | 
| string | $controller | The route's controller | 
| string|null | $name | The name to give this route | 
Return Value
| Route | 
RouteCollectionBuilder createBuilder()
Returns a RouteCollectionBuilder that can be configured and then added with mount().
Return Value
| RouteCollectionBuilder | 
mount(string $prefix, RouteCollectionBuilder $builder)
Add a RouteCollectionBuilder.
Parameters
| string | $prefix | |
| RouteCollectionBuilder | $builder | 
$this addRoute(Route $route, string|null $name = null)
Adds a Route object to the builder.
Parameters
| Route | $route | |
| string|null | $name | 
Return Value
| $this | 
$this setHost(string $pattern)
Sets the host on all embedded routes (unless already set).
Parameters
| string | $pattern | 
Return Value
| $this | 
$this setCondition(string $condition)
Sets a condition on all embedded routes (unless already set).
Parameters
| string | $condition | 
Return Value
| $this | 
$this setDefault(string $key, mixed $value)
Sets a default value that will be added to all embedded routes (unless that default value is already set).
Parameters
| string | $key | |
| mixed | $value | 
Return Value
| $this | 
$this setRequirement(string $key, mixed $regex)
Sets a requirement that will be added to all embedded routes (unless that requirement is already set).
Parameters
| string | $key | |
| mixed | $regex | 
Return Value
| $this | 
$this setOption(string $key, mixed $value)
Sets an option that will be added to all embedded routes (unless that option is already set).
Parameters
| string | $key | |
| mixed | $value | 
Return Value
| $this | 
$this setSchemes(array|string $schemes)
Sets the schemes on all embedded routes (unless already set).
Parameters
| array|string | $schemes | 
Return Value
| $this | 
$this setMethods(array|string $methods)
Sets the methods on all embedded routes (unless already set).
Parameters
| array|string | $methods | 
Return Value
| $this | 
RouteCollection build()
Creates the final RouteCollection and returns it.
Return Value
| RouteCollection | 
    © 2004–2017 Fabien Potencier
Licensed under the MIT License.
    http://api.symfony.com/4.0/Symfony/Component/Routing/RouteCollectionBuilder.html