function drupal_parse_url

Parses a system URL string into an associative array suitable for url().

This function should only be used for URLs that have been generated by the system, such as via url(). It should not be used for URLs that come from external sources, or URLs that link to external resources.

The returned array contains a 'path' that may be passed separately to url(). For example:

$options = drupal_parse_url($_GET['destination']);
$my_url = url($options['path'], $options);
$my_link = l('Example link', $options['path'], $options);

This is required, because url() does not support relative URLs containing a query string or fragment in its $path argument. Instead, any query string needs to be parsed into an associative query parameter array in $options['query'] and the fragment into $options['fragment'].

Parameters

$url: The URL string to parse, f.e. $_GET['destination'].

Return value

An associative array containing the keys:

  • 'path': The path of the URL. If the given $url is external, this includes the scheme and host.
  • 'query': An array of query parameters of $url, if existent.
  • 'fragment': The fragment of $url, if existent.

See also

url()

drupal_goto()

Related topics

HTTP handling
Functions to properly handle HTTP responses.
PHP wrapper functions
Functions that are wrappers or custom implementations of PHP functions.
6 calls to drupal_parse_url()
confirm_form in drupal/core/modules/system/system.module
Generates a form array for a confirmation form.
drupal_goto in drupal/core/includes/common.inc
Sends the user to a different Drupal page.
field_ui_get_destinations in drupal/core/modules/field_ui/field_ui.admin.inc
Extracts next redirect path from an array of multiple destinations.
link_field_prepare_view in drupal/core/modules/field/modules/link/link.module
Implements hook_field_prepare_view().
UrlTest::testDrupalParseUrl in drupal/core/modules/system/lib/Drupal/system/Tests/Common/UrlTest.php
Tests drupal_parse_url().

... See full list

File

drupal/core/includes/common.inc, line 587
Common functions that many Drupal modules will need to reference.

Code

function drupal_parse_url($url) {
  $options = array(
    'path' => NULL,
    'query' => array(),
    'fragment' => '',
  );

  // External URLs: not using parse_url() here, so we do not have to rebuild
  // the scheme, host, and path without having any use for it.
  if (strpos($url, '://') !== FALSE) {

    // Split off everything before the query string into 'path'.
    $parts = explode('?', $url);
    $options['path'] = $parts[0];

    // If there is a query string, transform it into keyed query parameters.
    if (isset($parts[1])) {
      $query_parts = explode('#', $parts[1]);
      parse_str($query_parts[0], $options['query']);

      // Take over the fragment, if there is any.
      if (isset($query_parts[1])) {
        $options['fragment'] = $query_parts[1];
      }
    }
  }
  else {

    // parse_url() does not support relative URLs, so make it absolute. E.g. the
    // relative URL "foo/bar:1" isn't properly parsed.
    $parts = parse_url('http://example.com/' . $url);

    // Strip the leading slash that was just added.
    $options['path'] = substr($parts['path'], 1);
    if (isset($parts['query'])) {
      parse_str($parts['query'], $options['query']);
    }
    if (isset($parts['fragment'])) {
      $options['fragment'] = $parts['fragment'];
    }
  }
  return $options;
}