interface UrlGeneratorInterface
Same name in other branches
- 9 core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php \Drupal\Core\Routing\UrlGeneratorInterface
- 8.9.x core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php \Drupal\Core\Routing\UrlGeneratorInterface
- 11.x core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php \Drupal\Core\Routing\UrlGeneratorInterface
Defines an interface for generating a URL from a route or system path.
Provides additional methods and options not present in the base interface.
Hierarchy
- interface \Drupal\Core\Routing\UrlGeneratorInterface extends \Symfony\Component\Routing\Generator\UrlGeneratorInterface
Expanded class hierarchy of UrlGeneratorInterface
All classes that implement UrlGeneratorInterface
17 files declare their use of UrlGeneratorInterface
- BlockContentBlock.php in core/
modules/ block_content/ src/ Plugin/ Block/ BlockContentBlock.php - EntityController.php in core/
lib/ Drupal/ Core/ Entity/ Controller/ EntityController.php - EntityUrlTest.php in core/
tests/ Drupal/ Tests/ Core/ Entity/ EntityUrlTest.php - FormSubmitter.php in core/
lib/ Drupal/ Core/ Form/ FormSubmitter.php - FormSubmitterTest.php in core/
tests/ Drupal/ Tests/ Core/ Form/ FormSubmitterTest.php
File
-
core/
lib/ Drupal/ Core/ Routing/ UrlGeneratorInterface.php, line 12
Namespace
Drupal\Core\RoutingView source
interface UrlGeneratorInterface extends SymfonyUrlGeneratorInterface {
/**
* Gets the internal path (system path) for a route.
*
* @param string|\Symfony\Component\Routing\Route $name
* The route name or a route object.
* @param array $parameters
* An array of parameters as passed to
* \Symfony\Component\Routing\Generator\UrlGeneratorInterface::generate().
*
* @return string
* The internal Drupal path corresponding to the route. This string is
* not urlencoded and will be an empty string for the front page.
*/
public function getPathFromRoute($name, $parameters = []);
/**
* Generates a URL or path for a specific route based on the given parameters.
*
* Parameters that reference placeholders in the route pattern will be
* substituted for them in the pattern. Extra params are added as query
* strings to the URL.
*
* @param string|\Symfony\Component\Routing\Route $name
* The route name or a route object.
* @param array $parameters
* An associative array of parameter names and values.
* @param array $options
* (optional) An associative array of additional options, with the following
* elements:
* - 'query': An array of query key/value-pairs (without any URL-encoding)
* to append to the URL.
* - 'fragment': A fragment identifier (named anchor) to append to the URL.
* Do not include the leading '#' character.
* - 'absolute': Defaults to FALSE. Whether to force the output to be an
* absolute link (beginning with http:). Useful for links that will be
* displayed outside the site, such as in an RSS feed.
* - 'language': An optional language object used to look up the alias
* for the URL. If $options['language'] is omitted, it defaults to the
* current language for the language type LanguageInterface::TYPE_URL.
* - 'https': Whether this URL should point to a secure location. If not
* defined, the current scheme is used, so the user stays on HTTP or HTTPS
* respectively. TRUE enforces HTTPS and FALSE enforces HTTP.
* - 'path_processing': Defaults to TRUE. Whether to pass the path to a
* processor manager to allow alterations.
* - 'base_url': Only used internally by a path processor, for example, to
* modify the base URL when a language dependent URL requires so.
* - 'prefix': Only used internally, to modify the path when a language
* dependent URL requires so.
* @param bool $collect_bubbleable_metadata
* (optional) Defaults to FALSE. When TRUE, both the generated URL and its
* associated bubbleable metadata are returned.
*
* @return string|\Drupal\Core\GeneratedUrl
* The generated URL for the given route.
* When $collect_bubbleable_metadata is TRUE, a GeneratedUrl object is
* returned, containing the generated URL plus bubbleable metadata.
*
* @throws \Symfony\Component\Routing\Exception\RouteNotFoundException
* Thrown when the named route does not exist.
* @throws \Symfony\Component\Routing\Exception\MissingMandatoryParametersException
* Thrown when some parameters are missing that are mandatory for the route.
* @throws \Symfony\Component\Routing\Exception\InvalidParameterException
* Thrown when a parameter value for a placeholder is not correct because it
* does not match the requirement.
*
* @internal
* Should not be used in user code.
* Use \Drupal\Core\Url instead.
*/
public function generateFromRoute($name, $parameters = [], $options = [], $collect_bubbleable_metadata = FALSE);
}
Members
Title Sort descending | Modifiers | Object type | Summary |
---|---|---|---|
UrlGeneratorInterface::generateFromRoute | public | function | Generates a URL or path for a specific route based on the given parameters. |
UrlGeneratorInterface::getPathFromRoute | public | function | Gets the internal path (system path) for a route. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.