function path_save | Documentation

1 path.inc path_save(&$path)

Save a URL alias to the database.

Parameters

$path: An associative array containing the following keys:

source: The internal system path.
alias: The URL alias.
pid: (optional) Unique URL alias identifier.
langcode: (optional) The language code of the alias.

10 calls to path_save()

LocalePathFunctionalTest::testPathLanguageConfiguration in core/modules/locale/tests/locale.test: Test if a language can be associated with a URL alias.
PathLookupTest::testBackdropLookupPath in core/modules/simpletest/tests/path.test: Test that backdrop_lookup_path() returns the correct path.
PathPatternTestHelper::saveAlias in core/modules/path/tests/path_pattern.test
PathSaveTest::testBackdropSaveOriginalPath in core/modules/simpletest/tests/path.test: Tests that path_save() makes the original path available to modules.
path_admin_form_submit in core/modules/path/path.admin.inc: Form submission handler for path_admin_form().

... See full list

File

core/includes/path.inc, line 433: Functions to handle paths in Backdrop, including URL aliasing.

Code

function path_save(&$path) {
  $path += array('langcode' => LANGUAGE_NONE);

  // Load the stored alias, if any.
  if (!empty($path['pid']) && !isset($path['original'])) {
    $path['original'] = path_load($path['pid']);
  }

  if (empty($path['pid'])) {
    backdrop_write_record('url_alias', $path);
    module_invoke_all('path_insert', $path);
  }
  else {
    backdrop_write_record('url_alias', $path, array('pid'));
    module_invoke_all('path_update', $path);
  }

  // Clear internal properties.
  unset($path['original']);

  // Clear the static alias cache.
  backdrop_clear_path_cache($path['source']);
}