interface UrlGeneratorInterface

Same name in other branches
  1. 9 core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php \Drupal\Core\Routing\UrlGeneratorInterface
  2. 8.9.x core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php \Drupal\Core\Routing\UrlGeneratorInterface
  3. 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

... See full list

File

core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php, line 12

Namespace

Drupal\Core\Routing
View 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.