function path_load

Fetches a specific URL alias from the database.

Parameters

$conditions: A string representing the source, a number representing the pid, or an array of query conditions.

Return value

FALSE if no alias was found or an associative array containing the following keys:

  • source: The internal system path.
  • alias: The URL alias.
  • pid: Unique path alias identifier.
  • language: The language of the alias.
5 calls to path_load()
PathLookupTest::testDrupalLookupPath in modules/simpletest/tests/path.test
Test that drupal_lookup_path() returns the correct path.
path_delete in includes/path.inc
Delete a URL alias.
path_form_node_form_alter in modules/path/path.module
Implements hook_form_BASE_FORM_ID_alter() for node_form().
path_form_taxonomy_form_term_alter in modules/path/path.module
Implements hook_form_FORM_ID_alter() for taxonomy_form_term().
path_save in includes/path.inc
Save a path alias to the database.

File

includes/path.inc, line 404

Code

function path_load($conditions) {
  if (is_numeric($conditions)) {
    $conditions = array(
      'pid' => $conditions,
    );
  }
  elseif (is_string($conditions)) {
    $conditions = array(
      'source' => $conditions,
    );
  }
  elseif (!is_array($conditions)) {
    return FALSE;
  }
  $select = db_select('url_alias');
  foreach ($conditions as $field => $value) {
    $select->condition($field, $value);
  }
  return $select->fields('url_alias')
    ->orderBy('pid', 'DESC')
    ->range(0, 1)
    ->execute()
    ->fetchAssoc();
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.