UnroutedUrlAssembler::buildExternalUrl

protected UnroutedUrlAssembler::buildExternalUrl($uri, array $options = [], $collect_bubbleable_metadata = FALSE)

File

core/lib/Drupal/Core/Utility/UnroutedUrlAssembler.php, line 70

Class

UnroutedUrlAssembler: Provides a way to build external or non Drupal local domain URLs.

Namespace

Drupal\Core\Utility

Code

protected function buildExternalUrl($uri, array $options = [], $collect_bubbleable_metadata = FALSE) {
  $this->addOptionDefaults($options);
  // Split off the fragment.
  if (strpos($uri, '#') !== FALSE) {
    list($uri, $old_fragment) = explode('#', $uri, 2);
    // If $options contains no fragment, take it over from the path.
    if (isset($old_fragment) && !$options['fragment']) {
      $options['fragment'] = '#' . $old_fragment;
    }
  }
 
  if (isset($options['https'])) {
    if ($options['https'] === TRUE) {
      $uri = str_replace('http://', 'https://', $uri);
    }
    elseif ($options['https'] === FALSE) {
      $uri = str_replace('https://', 'http://', $uri);
    }
  }
  // Append the query.
  if ($options['query']) {
    $uri .= (strpos($uri, '?') !== FALSE ? '&' : '?') . UrlHelper::buildQuery($options['query']);
  }
  // Reassemble.
  $url = $uri . $options['fragment'];
  return $collect_bubbleable_metadata ? (new GeneratedUrl())->setGeneratedUrl($url) : $url;
}

Links:

https://api.drupal.org/api/drupal/core%21lib%21Drupal%21Core%21Utility%21UnroutedUrlAssembler.php/function/UnroutedUrlAssembler%3A%3AbuildExternalUrl/8.2.x

doc_Drupal

2025-01-10 15:47:30

Comments