Symfony2 API
Class

Symfony\Bundle\FrameworkBundle\Routing\Router

class Router extends Router implements WarmableInterface

This Router creates the Loader only when the cache is empty.

Methods

__construct(ContainerInterface $container, mixed $resource, array $options = array(), RequestContext $context = null)

Constructor.
setOptions(array $options)

Sets options.

 from Router
setOption(string $key, mixed $value)

Sets an option.

 from Router
mixed getOption(string $key)

Gets an option value.

 from Router
RouteCollection getRouteCollection()

Gets the RouteCollection instance associated with this Router.
setContext(RequestContext $context)

{@inheritdoc}

 from Router
getContext()

{@inheritdoc}

 from Router
string generate(string $name, mixed $parameters = array(), Boolean|string $referenceType = self::ABSOLUTE_PATH)

Generates a URL or path for a specific route based on the given parameters.

 from Router
array match(string $pathinfo)

Tries to match a URL path with a set of routes.

 from Router
UrlMatcherInterface getMatcher()

Gets the UrlMatcher instance associated with this Router.

 from Router
UrlGeneratorInterface getGenerator()

Gets the UrlGenerator instance associated with this Router.

 from Router
warmUp(string $cacheDir)

Warms up the cache.

Details

at line 39
public __construct(ContainerInterface $container, mixed $resource, array $options = array(), RequestContext $context = null)

Constructor.

Parameters

ContainerInterface $container A ContainerInterface instance
mixed $resource The main resource to load
array $options An array of options
RequestContext $context The context

in Router at line 100
public setOptions(array $options)

Sets options.

Available options:

* cache_dir: The cache directory (or null to disable caching)
* debug: Whether to enable debugging or not (false by default)
* resource_type: Type hint for the main resource (optional)

Parameters

array $options An array of options

Exceptions

InvalidArgumentException When unsupported option is provided

in Router at line 140
public setOption(string $key, mixed $value)

Sets an option.

Parameters

string $key The key
mixed $value The value

Exceptions

InvalidArgumentException

in Router at line 158
public mixed getOption(string $key)

Gets an option value.

Parameters

string $key The key

Return Value

mixed The value

Exceptions

InvalidArgumentException

at line 51
public RouteCollection getRouteCollection()

Gets the RouteCollection instance associated with this Router.

Return Value

RouteCollection A RouteCollection instance

in Router at line 182
public setContext(RequestContext $context)

{@inheritdoc}

Parameters

RequestContext $context

in Router at line 197
public getContext()

{@inheritdoc}

in Router at line 205
public string generate(string $name, mixed $parameters = array(), Boolean|string $referenceType = self::ABSOLUTE_PATH)

Generates a URL or path for a specific route based on the given parameters.

Parameters that reference placeholders in the route pattern will substitute them in the
path or host. Extra params are added as query string to the URL.

When the passed reference type cannot be generated for the route because it requires a different
host or scheme than the current one, the method will return a more comprehensive reference
that includes the required params. For example, when you call this method with $referenceType = ABSOLUTE_PATH
but the route requires the https scheme whereas the current scheme is http, it will instead return an
ABSOLUTE_URL with the https scheme and the current host. This makes sure the generated URL matches
the route in any case.

If there is no route with the given name, the generator must throw the RouteNotFoundException.

Parameters

string $name The name of the route
mixed $parameters An array of parameters
Boolean|string $referenceType The type of reference to be generated (one of the constants)

Return Value

string The generated URL

Exceptions

RouteNotFoundException If the named route doesn't exist
MissingMandatoryParametersException When some parameters are missing that are mandatory for the route
InvalidParameterException When a parameter value for a placeholder is not correct because it does not match the requirement

in Router at line 213
public array match(string $pathinfo)

Tries to match a URL path with a set of routes.

If the matcher can not find information, it must throw one of the exceptions documented
below.

Parameters

string $pathinfo The path info to be parsed (raw format, i.e. not urldecoded)

Return Value

array An array of parameters

Exceptions

ResourceNotFoundException If the resource could not be found
MethodNotAllowedException If the resource was found but the request method is not allowed

in Router at line 223
public UrlMatcherInterface getMatcher()

Gets the UrlMatcher instance associated with this Router.

Return Value

UrlMatcherInterface A UrlMatcherInterface instance

in Router at line 256
public UrlGeneratorInterface getGenerator()

Gets the UrlGenerator instance associated with this Router.

Return Value

UrlGeneratorInterface A UrlGeneratorInterface instance

at line 64
public warmUp(string $cacheDir)

Warms up the cache.

Parameters

string $cacheDir The cache directory