Same name and namespace in other branches
  1. 4.6.x includes/bootstrap.inc \drupal_get_path_alias()
  2. 4.7.x includes/path.inc \drupal_get_path_alias()
  3. 5.x includes/path.inc \drupal_get_path_alias()
  4. 6.x includes/path.inc \drupal_get_path_alias()

Given an internal Drupal path, return the alias set by the administrator.

If no path is provided, the function will return the alias of the current page.

Parameters

$path: An internal Drupal path.

$path_language: An optional language code to look up the path in.

Return value

An aliased path if one was found, or the original path if no alias was found.

5 calls to drupal_get_path_alias()
block_block_list_alter in modules/block/block.module
Implements hook_block_list_alter().
path_admin_overview in modules/path/path.admin.inc
Returns a listing of all defined URL aliases.
system_site_information_settings in modules/system/system.admin.inc
Form builder; The general site information form.
url in includes/common.inc
Generates an internal or external URL.
_statistics_link in modules/statistics/statistics.module
Generates a link to a path, truncating the displayed text to a given width.

File

includes/path.inc, line 235
Functions to handle paths in Drupal, including path aliasing.

Code

function drupal_get_path_alias($path = NULL, $path_language = NULL) {

  // If no path is specified, use the current page's path.
  if ($path == NULL) {
    $path = $_GET['q'];
  }
  $result = $path;
  if ($alias = drupal_lookup_path('alias', $path, $path_language)) {
    $result = $alias;
  }
  return $result;
}