• contents
• Available methods (14)

• protected translatedMarkup -> NULL

  protected options -> array(0)

  →protected stringTranslation -> Drupal\Core\StringTranslation\TranslationManager(4)

  *DEPTH TOO GREAT*

  protected string -> string(4) "Home"

  protected arguments -> array(0)

• →public __construct($string, array $arguments = array(), array $options = array(), Drupal\Core\StringTranslation\TranslationInterface $string_translation = NULL)

  Constructs a new class instance.
  
  When possible, use the
  \Drupal\Core\StringTranslation\StringTranslationTrait $this->t(). Otherwise
  create a new \Drupal\Core\StringTranslation\TranslatableMarkup object
  directly.
  
  Calling the trait's t() method or instantiating a new TranslatableMarkup
  object serves two purposes:
  - At run-time it translates user-visible text into the appropriate
  language.
  - Static analyzers detect calls to t() and new TranslatableMarkup, and add
  the first argument (the string to be translated) to the database of
  strings that need translation. These strings are expected to be in
  English, so the first argument should always be in English.
  To allow the site to be localized, it is important that all human-readable
  text that will be displayed on the site or sent to a user is made available
  in one of the ways supported by the
  @link https://www.drupal.org/node/322729 Localization API @endlink.
  See the @link https://www.drupal.org/node/322729 Localization API @endlink
  pages for more information, including recommendations on how to break up or
  not break up strings for translation.
  
  @section sec_translating_vars Translating Variables
  $string should always be an English literal string.
  
  $string should never contain a variable, such as:
  @code
  new TranslatableMarkup($text)
  @endcode
  There are several reasons for this:
  - Using a variable for $string that is user input is a security risk.
  - Using a variable for $string that has even guaranteed safe text (for
  example, user interface text provided literally in code), will not be
  picked up by the localization static text processor. (The parameter could
  be a variable if the entire string in $text has been passed into t() or
  new TranslatableMarkup() elsewhere as the first argument, but that
  strategy is not recommended.)
  
  It is especially important never to call new TranslatableMarkup($user_text)
  or t($user_text) where $user_text is some text that a user entered -- doing
  that can lead to cross-site scripting and other security problems. However,
  you can use variable substitution in your string, to put variable text such
  as user names or link URLs into translated text. Variable substitution
  looks like this:
  @code
  new TranslatableMarkup("@name's blog", array('@name' => $account->getDisplayName()));
  @endcode
  Basically, you can put placeholders like @name into your string, and the
  method will substitute the sanitized values at translation time. (See the
  Localization API pages referenced above and the documentation of
  \Drupal\Component\Render\FormattableMarkup::placeholderFormat()
  for details about how to safely and correctly define variables in your
  string.) Translators can then rearrange the string as necessary for the
  language (e.g., in Spanish, it might be "blog de @name").
  
  @param string $string
  A string containing the English text to translate.
  @param array $arguments
  (optional) An associative array of replacements to make after
  translation. Based on the first character of the key, the value is
  escaped and/or themed. See
  \Drupal\Component\Render\FormattableMarkup::placeholderFormat() for
  details.
  @param array $options
  (optional) An associative array of additional options, with the following
  elements:
  - 'langcode' (defaults to the current language): A language code, to
  translate to a language other than what is used to display the page.
  - 'context' (defaults to the empty context): The context the source
  string belongs to.
  @param \Drupal\Core\StringTranslation\TranslationInterface $string_translation
  (optional) The string translation service.
  
  @throws \InvalidArgumentException
  Exception thrown when $string is not a string.
  
  @see \Drupal\Component\Render\FormattableMarkup::placeholderFormat()
  @see \Drupal\Core\StringTranslation\StringTranslationTrait::t()
  
  @ingroup sanitization
  
  Defined in <ROOT>/core/lib/Drupal/Core/StringTranslation/TranslatableMarkup.php:129

  →public __sleep()

  Magic __sleep() method to avoid serializing the string translator.
  
  Defined in <ROOT>/core/lib/Drupal/Core/StringTranslation/TranslatableMarkup.php:203

  →public __toString()

  Implements the magic __toString() method.
  
  Defined in <ROOT>/core/lib/Drupal/Component/Utility/ToStringTrait.php:13

  →public count() -> int

  Returns the string length.
  
  @return int
  The length of the string.
  
  Defined in <ROOT>/core/lib/Drupal/Core/StringTranslation/TranslatableMarkup.php:227

  →public getArguments() -> mixed[]

  Gets all arguments from this translated string.
  
  @return mixed[]
  The array of arguments.
  
  Defined in <ROOT>/core/lib/Drupal/Core/StringTranslation/TranslatableMarkup.php:178

  →public getOption($name) -> mixed

  Gets a specific option from this translated string.
  
  @param string $name
  Option name.
  
  @return mixed
  The value of this option or empty string of option is not set.
  
  Defined in <ROOT>/core/lib/Drupal/Core/StringTranslation/TranslatableMarkup.php:158

  →public getOptions() -> mixed[]

  Gets all options from this translated string.
  
  @return mixed[]
  The array of options.
  
  Defined in <ROOT>/core/lib/Drupal/Core/StringTranslation/TranslatableMarkup.php:168

  →public getUntranslatedString() -> string

  Gets the untranslated string value stored in this translated string.
  
  @return string
  The string stored in this wrapper.
  
  Defined in <ROOT>/core/lib/Drupal/Core/StringTranslation/TranslatableMarkup.php:145

  →public jsonSerialize() -> string

  Returns a representation of the object for use in JSON serialization.
  
  @return string
  The safe string content.
  
  Inherited from Drupal\Component\Render\FormattableMarkup
  Defined in <ROOT>/core/lib/Drupal/Component/Render/FormattableMarkup.php:118

  →public render() -> string

  Renders the object as a string.
  
  @return string
  The translated string.
  
  Defined in <ROOT>/core/lib/Drupal/Core/StringTranslation/TranslatableMarkup.php:188

  →protected static placeholderEscape($value) -> string

  Escapes a placeholder replacement value if needed.
  
  @param string|\Drupal\Component\Render\MarkupInterface $value
  A placeholder replacement value.
  
  @return string
  The properly escaped replacement value.
  
  Inherited from Drupal\Component\Render\FormattableMarkup
  Defined in <ROOT>/core/lib/Drupal/Component/Render/FormattableMarkup.php:264

  →protected static placeholderFormat($string, array $args) -> string

  Replaces placeholders in a string with values.
  
  @param string $string
  A string containing placeholders. The string itself is expected to be
  safe and correct HTML. Any unsafe content must be in $args and
  inserted via placeholders.
  @param array $args
  An associative array of replacements. Each array key should be the same
  as a placeholder in $string. The corresponding value should be a string
  or an object that implements
  \Drupal\Component\Render\MarkupInterface. The value replaces the
  placeholder in $string. Sanitization and formatting will be done before
  replacement. The type of sanitization and formatting depends on the first
  character of the key:
  - @variable: When the placeholder replacement value is:
  - A string, the replaced value in the returned string will be sanitized
  using \Drupal\Component\Utility\Html::escape().
  - A MarkupInterface object, the replaced value in the returned string
  will not be sanitized.
  - A MarkupInterface object cast to a string, the replaced value in the
  returned string be forcibly sanitized using
  \Drupal\Component\Utility\Html::escape().
  @code
  $this->placeholderFormat('This will force HTML-escaping of the replacement value: @text', ['@text' => (string) $safe_string_interface_object));
  @endcode
  Use this placeholder as the default choice for anything displayed on
  the site, but not within HTML attributes, JavaScript, or CSS. Doing so
  is a security risk.
  - %variable: Use when the replacement value is to be wrapped in <em>
  tags.
  A call like:
  @code
  $string = "%output_text";
  $arguments = ['%output_text' => 'text output here.'];
  $this->placeholderFormat($string, $arguments);
  @endcode
  makes the following HTML code:
  @code
  <em class="placeholder">text output here.</em>
  @endcode
  As with @variable, do not use this within HTML attributes, JavaScript,
  or CSS. Doing so is a security risk.
  - :variable: Return value is escaped with
  \Drupal\Component\Utility\Html::escape() and filtered for dangerous
  protocols using UrlHelper::stripDangerousProtocols(). Use this when
  using the "href" attribute, ensuring the attribute value is always
  wrapped in quotes:
  @code
  // Secure (with quotes):
  $this->placeholderFormat('<a href=":url">@variable</a>', [':url' => $url, '@variable' => $variable]);
  // Insecure (without quotes):
  $this->placeholderFormat('<a href=:url>@variable</a>', [':url' => $url, '@variable' => $variable]);
  @endcode
  When ":variable" comes from arbitrary user input, the result is secure,
  but not guaranteed to be a valid URL (which means the resulting output
  could fail HTML validation). To guarantee a valid URL, use
  Url::fromUri($user_input)->toString() (which either throws an exception
  or returns a well-formed URL) before passing the result into a
  ":variable" placeholder.
  
  @return string
  A formatted HTML string with the placeholders replaced.
  
  @ingroup sanitization
  
  @see \Drupal\Core\StringTranslation\TranslatableMarkup
  @see \Drupal\Core\StringTranslation\PluralTranslatableMarkup
  @see \Drupal\Component\Utility\Html::escape()
  @see \Drupal\Component\Utility\UrlHelper::stripDangerousProtocols()
  @see \Drupal\Core\Url::fromUri()
  
  Inherited from Drupal\Component\Render\FormattableMarkup
  Defined in <ROOT>/core/lib/Drupal/Component/Render/FormattableMarkup.php:194

  →protected _die()

  For test purposes, wrap die() in an overridable method.
  
  Defined in <ROOT>/core/lib/Drupal/Component/Utility/ToStringTrait.php:31

  →protected getStringTranslation() -> \Drupal\Core\StringTranslation\TranslationInterface

  Gets the string translation service.
  
  @return \Drupal\Core\StringTranslation\TranslationInterface
  The string translation service.
  
  Defined in <ROOT>/core/lib/Drupal/Core/StringTranslation/TranslatableMarkup.php:213

• contents
• Available methods (37)
• Static class properties (3)

• protected urlGenerator -> NULL

  protected urlAssembler -> NULL

  protected accessManager -> NULL

  protected routeName -> string(7) "<front>"

  protected routeParameters -> array(0)

  protected options -> array(0)

  protected external -> boolFALSE

  protected unrouted -> boolFALSE

  protected uri -> NULL

  protected internalPath -> NULL

  protected _serviceIds -> array(0)

  protected _entityStorages -> array(0)

• →public static createFromRequest(Symfony\Component\HttpFoundation\Request $request) -> static

  Returns the Url object matching a request.
  
  SECURITY NOTE: The request path is not checked to be valid and accessible
  by the current user to allow storing and reusing Url objects by different
  users. The 'path.validator' service getUrlIfValid() method should be used
  instead of this one if validation and access check is desired. Otherwise,
  'access_manager' service checkNamedRoute() method should be used on the
  router name and parameters stored in the Url object returned by this
  method.
  
  @param \Symfony\Component\HttpFoundation\Request $request
  A request object.
  
  @return static
  A Url object. Warning: the object is created even if the current user
  would get an access denied running the same request via the normal page
  flow.
  
  @throws \Drupal\Core\Routing\MatchingRouteNotFoundException
  Thrown when the request cannot be matched.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:485

  →public static fromRoute($route_name, $route_parameters = array(), $options = array()) -> static

  Creates a new Url object for a URL that has a Drupal route.
  
  This method is for URLs that have Drupal routes (that is, most pages
  generated by Drupal). For non-routed local URIs relative to the base
  path (like robots.txt) use Url::fromUri() with the base: scheme.
  
  @param string $route_name
  The name of the route
  @param array $route_parameters
  (optional) An associative array of route parameter names and values.
  @param array $options
  See \Drupal\Core\Url::fromUri() for details.
  
  @return static
  A new Url object for a routed (internal to Drupal) URL.
  
  @see \Drupal\Core\Url::fromUserInput()
  @see \Drupal\Core\Url::fromUri()
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:150

  →public static fromRouteMatch(Drupal\Core\Routing\RouteMatchInterface $route_match) -> static

  Creates a new URL object from a route match.
  
  @param \Drupal\Core\Routing\RouteMatchInterface $route_match
  The route match.
  
  @return static
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:162

  →public static fromUri($uri, $options = array()) -> static

  Creates a new Url object from a URI.
  
  This method is for generating URLs for URIs that:
  - do not have Drupal routes: both external URLs and unrouted local URIs
  like base:robots.txt
  - do have a Drupal route but have a custom scheme to simplify linking.
  Currently, there is only the entity: scheme (This allows URIs of the
  form entity:{entity_type}/{entity_id}. For example: entity:node/1
  resolves to the entity.node.canonical route with a node parameter of 1.)
  
  For URLs that have Drupal routes (that is, most pages generated by Drupal),
  use Url::fromRoute().
  
  @param string $uri
  The URI of the resource including the scheme. For user input that may
  correspond to a Drupal route, use internal: for the scheme. For paths
  that are known not to be handled by the Drupal routing system (such as
  static files), use base: for the scheme to get a link relative to the
  Drupal base path (like the <base> HTML element). For a link to an entity
  you may use entity:{entity_type}/{entity_id} URIs. The internal: scheme
  should be avoided except when processing actual user input that may or
  may not correspond to a Drupal route. Normally use Url::fromRoute() for
  code linking to any any Drupal page.
  @param array $options
  (optional) An associative array of additional URL 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.
  - 'attributes': An associative array of HTML attributes that will be
  added to the anchor tag if you use the \Drupal\Core\Link class to make
  the link.
  - '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.
  
  @return static
  A new Url object with properties depending on the URI scheme. Call the
  access() method on this to do access checking.
  
  @throws \InvalidArgumentException
  Thrown when the passed in path has no scheme.
  
  @see \Drupal\Core\Url::fromRoute()
  @see \Drupal\Core\Url::fromUserInput()
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:275

  →public static fromUserInput($user_input, $options = array()) -> static

  Creates a Url object for a relative URI reference submitted by user input.
  
  Use this method to create a URL for user-entered paths that may or may not
  correspond to a valid Drupal route.
  
  @param string $user_input
  User input for a link or path. The first character must be one of the
  following characters:
  - '/': A path within the current site. This path might be to a Drupal
  route (e.g., '/admin'), to a file (e.g., '/README.txt'), or to
  something processed by a non-Drupal script (e.g.,
  '/not/a/drupal/page'). If the path matches a Drupal route, then the
  URL generation will include Drupal's path processors (e.g.,
  language-prefixing and aliasing). Otherwise, the URL generation will
  just append the passed-in path to Drupal's base path.
  - '?': A query string for the current page or resource.
  - '#': A fragment (jump-link) on the current page or resource.
  This helps reduce ambiguity for user-entered links and paths, and
  supports user interfaces where users may normally use auto-completion
  to search for existing resources, but also may type one of these
  characters to link to (e.g.) a specific path on the site.
  (With regard to the URI specification, the user input is treated as a
  @link https://tools.ietf.org/html/rfc3986#section-4.2 relative URI reference @endlink
  where the relative part is of type
  @link https://tools.ietf.org/html/rfc3986#section-3.3 path-abempty @endlink.)
  @param array $options
  (optional) An array of options. See Url::fromUri() for details.
  
  @return static
  A new Url object based on user input.
  
  @throws \InvalidArgumentException
  Thrown when the user input does not begin with one of the following
  characters: '/', '?', or '#'.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:207

  →public static renderAccess(array $element) -> bool

  Checks a Url render element against applicable access check services.
  
  @param array $element
  A render element as returned from \Drupal\Core\Url::toRenderArray().
  
  @return bool
  Returns TRUE if the current user has access to the url, otherwise FALSE.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:832

  →public static trustedCallbacks()

  {@inheritdoc}
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:902

  →public __construct($route_name, $route_parameters = array(), $options = array())

  Constructs a new Url object.
  
  In most cases, use Url::fromRoute() or Url::fromUri() rather than
  constructing Url objects directly in order to avoid ambiguity and make your
  code more self-documenting.
  
  @param string $route_name
  The name of the route
  @param array $route_parameters
  (optional) An associative array of parameter names and values.
  @param array $options
  See \Drupal\Core\Url::fromUri() for details.
  
  @see static::fromRoute()
  @see static::fromUri()
  
  @todo Update this documentation for non-routed URIs in
  https://www.drupal.org/node/2346787
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:124

  →public __sleep()

  {@inheritdoc}
  
  Defined in <ROOT>/core/lib/Drupal/Core/DependencyInjection/DependencySerializationTrait.php:30

  →public __wakeup()

  {@inheritdoc}
  
  Defined in <ROOT>/core/lib/Drupal/Core/DependencyInjection/DependencySerializationTrait.php:65

  →public access(Drupal\Core\Session\AccountInterface $account = NULL) -> bool

  Checks this Url object against applicable access check services.
  
  Determines whether the route is accessible or not.
  
  @param \Drupal\Core\Session\AccountInterface $account
  (optional) Run access checks for this account. Defaults to the current
  user.
  
  @return bool
  Returns TRUE if the user has access to the url, otherwise FALSE.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:816

  →public getInternalPath() -> string

  Returns the internal path (system path) for this route.
  
  This path will not include any prefixes, fragments, or query strings.
  
  @return string
  The internal path for this route.
  
  @throws \UnexpectedValueException.
  If this is a URI with no corresponding system path.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:793

  →public getOption($name) -> mixed

  Gets a specific option.
  
  See \Drupal\Core\Url::fromUri() for details on the options.
  
  @param string $name
  The name of the option.
  
  @return mixed
  The value for a specific option, or NULL if it does not exist.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:648

  →public getOptions() -> array

  Returns the URL options.
  
  @return array
  The array of options. See \Drupal\Core\Url::fromUri() for details on what
  it contains.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:633

  →public getRouteName() -> string

  Returns the route name.
  
  @return string
  
  @throws \UnexpectedValueException.
  If this is a URI with no corresponding route.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:562

  →public getRouteParameters() -> array

  Returns the route parameters.
  
  @return array
  
  @throws \UnexpectedValueException.
  If this is a URI with no corresponding route.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:578

  →public getUri() -> string

  Returns the URI value for this Url object.
  
  Only to be used if self::$unrouted is TRUE.
  
  @return string
  A URI not connected to a route. May be an external URL.
  
  @throws \UnexpectedValueException
  Thrown when the URI was requested for a routed URL.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:715

  →public isExternal() -> bool

  Indicates if this Url is external.
  
  @return bool
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:541

  →public isRouted() -> bool

  Indicates if this Url has a Drupal route.
  
  @return bool
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:550

  →public mergeOptions($options) -> $this

  Merges the URL options with any currently set.
  
  In the case of conflict with existing options, the new options will replace
  the existing options.
  
  @param array $options
  The array of options. See \Drupal\Core\Url::fromUri() for details on what
  it contains.
  
  @return $this
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:699

  →public setAbsolute($absolute = true) -> $this

  Sets the value of the absolute option for this Url.
  
  @param bool $absolute
  (optional) Whether to make this Url absolute or not. Defaults to TRUE.
  
  @return $this
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:731

  →public setOption($name, $value) -> $this

  Sets a specific option.
  
  See \Drupal\Core\Url::fromUri() for details on the options.
  
  @param string $name
  The name of the option.
  @param mixed $value
  The option value.
  
  @return $this
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:682

  →public setOptions($options) -> $this

  Sets the URL options.
  
  @param array $options
  The array of options. See \Drupal\Core\Url::fromUri() for details on what
  it contains.
  
  @return $this
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:665

  →public setRouteParameter($key, $value) -> $this

  Sets a specific route parameter.
  
  @param string $key
  The key of the route parameter.
  @param mixed $value
  The route parameter.
  
  @return $this
  
  @throws \UnexpectedValueException.
  If this is a URI with no corresponding route.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:618

  →public setRouteParameters($parameters) -> $this

  Sets the route parameters.
  
  @param array $parameters
  The array of parameters.
  
  @return $this
  
  @throws \UnexpectedValueException.
  If this is a URI with no corresponding route.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:597

  →public setUnroutedUrlAssembler(Drupal\Core\Utility\UnroutedUrlAssemblerInterface $url_assembler) -> $this

  Sets the unrouted URL assembler.
  
  @param \Drupal\Core\Utility\UnroutedUrlAssemblerInterface $url_assembler
  The unrouted URL assembler.
  
  @return $this
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:894

  →public setUrlGenerator(Drupal\Core\Routing\UrlGeneratorInterface $url_generator = NULL) -> $this

  Sets the URL generator.
  
  @param \Drupal\Core\Routing\UrlGeneratorInterface $url_generator
  (optional) The URL generator, specify NULL to reset it.
  
  @return $this
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:880

  →public toRenderArray() -> array

  Returns the route information for a render array.
  
  @return array
  An associative array suitable for a render array.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:771

  →public toString($collect_bubbleable_metadata = false) -> string|\Drupal\Core\GeneratedUrl

  Generates the string URL representation for this Url object.
  
  For an external URL, the string will contain the input plus any query
  string or fragment specified by the options array.
  
  If this Url object was constructed from a Drupal route or from an internal
  URI (URIs using the internal:, base:, or entity: schemes), the returned
  string will either be a relative URL like /node/1 or an absolute URL like
  http://example.com/node/1 depending on the options array, plus any
  specified query string or fragment.
  
  @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
  A string URL.
  When $collect_bubbleable_metadata is TRUE, a GeneratedUrl object is
  returned, containing the generated URL plus bubbleable metadata.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:757

  →public toUriString() -> string

  Generates a URI string that represents the data in the Url object.
  
  The URI will typically have the scheme of route: even if the object was
  constructed using an entity: or internal: scheme. A internal: URI that
  does not match a Drupal route with be returned here with the base: scheme,
  and external URLs will be returned in their original form.
  
  @return string
  A URI representation of the Url object data.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:521

  →protected static fromEntityUri(array $uri_parts, array $options, $uri) -> static

  Create a new Url object for entity URIs.
  
  @param array $uri_parts
  Parts from an URI of the form entity:{entity_type}/{entity_id} as from
  parse_url().
  @param array $options
  An array of options, see \Drupal\Core\Url::fromUri() for details.
  @param string $uri
  The original entered URI.
  
  @return static
  A new Url object for an entity's canonical route.
  
  @throws \InvalidArgumentException
  Thrown if the entity URI is invalid.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:350

  →protected static fromInternalUri(array $uri_parts, array $options) -> static

  Creates a new Url object for 'internal:' URIs.
  
  Important note: the URI minus the scheme can NOT simply be validated by a
  \Drupal\Core\Path\PathValidatorInterface implementation. The semantics of
  the 'internal:' URI scheme are different:
  - PathValidatorInterface accepts paths without a leading slash (e.g.
  'node/add') as well as 2 special paths: '<front>' and '<none>', which are
  mapped to the correspondingly named routes.
  - 'internal:' URIs store paths with a leading slash that represents the
  root — i.e. the front page — (e.g. 'internal:/node/add'), and doesn't
  have any exceptions.
  
  To clarify, a few examples of path plus corresponding 'internal:' URI:
  - 'node/add' -> 'internal:/node/add'
  - 'node/add?foo=bar' -> 'internal:/node/add?foo=bar'
  - 'node/add#kitten' -> 'internal:/node/add#kitten'
  - '<front>' -> 'internal:/'
  - '<front>foo=bar' -> 'internal:/?foo=bar'
  - '<front>#kitten' -> 'internal:/#kitten'
  - '<none>' -> 'internal:'
  - '<none>foo=bar' -> 'internal:?foo=bar'
  - '<none>#kitten' -> 'internal:#kitten'
  
  Therefore, when using a PathValidatorInterface to validate 'internal:'
  URIs, we must map:
  - 'internal:' (path component is '')  to the special '<none>' path
  - 'internal:/' (path component is '/') to the special '<front>' path
  - 'internal:/some-path' (path component is '/some-path') to 'some-path'
  
  @param array $uri_parts
  Parts from an URI of the form internal:{path} as from parse_url().
  @param array $options
  An array of options, see \Drupal\Core\Url::fromUri() for details.
  
  @return static
  A new Url object for a 'internal:' URI.
  
  @throws \InvalidArgumentException
  Thrown when the URI's path component doesn't have a leading slash.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:400

  →protected static fromRouteUri(array $uri_parts, array $options, $uri) -> static

  Creates a new Url object for 'route:' URIs.
  
  @param array $uri_parts
  Parts from an URI of the form route:{route_name};{route_parameters} as
  from parse_url(), where the path is the route name optionally followed by
  a ";" followed by route parameters in key=value format with & separators.
  @param array $options
  An array of options, see \Drupal\Core\Url::fromUri() for details.
  @param string $uri
  The original passed in URI.
  
  @return static
  A new Url object for a 'route:' URI.
  
  @throws \InvalidArgumentException
  Thrown when the route URI does not have a route name.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:449

  →protected accessManager() -> \Drupal\Core\Access\AccessManagerInterface

  @return \Drupal\Core\Access\AccessManagerInterface
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:839

  →protected setUnrouted() -> $this

  Sets this Url to encapsulate an unrouted URI.
  
  @return $this
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:499

  →protected unroutedUrlAssembler() -> \Drupal\Core\Utility\UnroutedUrlAssemblerInterface

  Gets the unrouted URL assembler for non-Drupal URLs.
  
  @return \Drupal\Core\Utility\UnroutedUrlAssemblerInterface
  The unrouted URL assembler.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:865

  →protected urlGenerator() -> \Drupal\Core\Routing\UrlGeneratorInterface

  Gets the URL generator.
  
  @return \Drupal\Core\Routing\UrlGeneratorInterface
  The URL generator.
  
  Defined in <ROOT>/core/lib/Drupal/Core/Url.php:852

• constant THROW_EXCEPTION :: string(9) "exception"

  constant TRIGGER_WARNING :: string(7) "warning"

  constant TRIGGER_SILENCED_DEPRECATION :: string(20) "silenced_deprecation"

Creates a Link object from a given route name and parameters.

@param string $text
The text of the link.
@param string $route_name
The name of the route
@param array $route_parameters
(optional) An associative array of parameter names and values.
@param array $options
The options parameter takes exactly the same structure.
See \Drupal\Core\Url::fromUri() for details.

@return static

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:62

Creates a Link object from a given Url object.

@param string|array|\Drupal\Component\Render\MarkupInterface $text
The link text for the anchor tag as a translated string or render array.
@param \Drupal\Core\Url $url
The Url to create the link for.

@return static

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:76

Constructs a new Link object.

@param string $text
The text of the link.
@param \Drupal\Core\Url $url
The url object.

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:42

Returns the text of the link.

@return string

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:85

Returns the URL of the link.

@return \Drupal\Core\Url

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:107

Sets the link generator service.

@param \Drupal\Core\Utility\LinkGeneratorInterface $generator
The link generator service.

@return $this

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:173

Sets the new text of the link.

@param string $text
The new text.

@return $this

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:97

Sets the URL of this link.

@param Url $url
The URL object to set

@return $this

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:119

{@inheritdoc}

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:144

Generates the HTML for this Link object.

Do not use this method to render a link in an HTML context. In an HTML
context, self::toRenderable() should be used so that render cache
information is maintained. However, there might be use cases such as tests
and non-HTML contexts where calling this method directly makes sense.

@return \Drupal\Core\GeneratedLink
The link HTML markup.

@see \Drupal\Core\Link::toRenderable()

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:137

Returns the link generator.

@return \Drupal\Core\Utility\LinkGeneratorInterface
The link generator

Defined in <ROOT>/core/lib/Drupal/Core/Link.php:158