Entity::url

public Entity::url($rel = 'canonical', $options = array())

Gets the public URL for this entity.

Parameters

string $rel: The link relationship type, for example: canonical or edit-form.

array $options: See \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute() for the available options.

Return value

string The URL for this entity.

Overrides EntityInterface::url

Deprecated

in Drupal 8.0.0, intended to be removed in Drupal 9.0.0 Please use toUrl() instead.

File

core/lib/Drupal/Core/Entity/Entity.php, line 278

Class

Entity: Defines a base entity class.

Namespace

Drupal\Core\Entity

Code

public function url($rel = 'canonical', $options = array()) {
  // While self::toUrl() will throw an exception if the entity has no id,
  // the expected result for a URL is always a string.
  if ($this->id() === NULL || !$this->hasLinkTemplate($rel)) {
    return '';
  }
 
  $uri = $this->toUrl($rel);
  $options += $uri->getOptions();
  $uri->setOptions($options);
  return $uri->toString();
}

Links:

https://api.drupal.org/api/drupal/core%21lib%21Drupal%21Core%21Entity%21Entity.php/function/Entity%3A%3Aurl/8.2.x

doc_Drupal

2025-01-10 15:47:30

Comments