public function AliasStorage::save

public AliasStorage::save($source, $alias, $langcode = LanguageInterface::LANGCODE_NOT_SPECIFIED, $pid = NULL)

Saves a path alias to the database.

@thrown \InvalidArgumentException Thrown when either the source or alias has not a starting slash.

Parameters

string $source: The internal system path.

string $alias: The URL alias.

string $langcode: (optional) The language code of the alias.

int|null $pid: (optional) Unique path alias identifier.

Return value

array|false FALSE if the path could not be saved or an associative array containing the following keys:

• source (string): The internal system path with a starting slash.
• alias (string): The URL alias with a starting slash.
• pid (int): Unique path alias identifier.
• langcode (string): The language code of the alias.
• original: For updates, an array with source, alias and langcode with the previous values.

Overrides AliasStorageInterface::save

File

core/lib/Drupal/Core/Path/AliasStorage.php, line 56

Class

AliasStorage

Provides a class for CRUD operations on path aliases.

Namespace

Drupal\Core\Path

Code

public function save($source, $alias, $langcode = LanguageInterface::LANGCODE_NOT_SPECIFIED, $pid = NULL) {

  if ($source[0] !== '/') {
    throw new \InvalidArgumentException(sprintf('Source path %s has to start with a slash.', $source));
  }

  if ($alias[0] !== '/') {
    throw new \InvalidArgumentException(sprintf('Alias path %s has to start with a slash.', $alias));
  }

  $fields = array(
    'source' => $source,
    'alias' => $alias,
    'langcode' => $langcode,
  );

  // Insert or update the alias.
  if (empty($pid)) {
    $try_again = FALSE;
    try {
      $query = $this->connection->insert(static::TABLE)
        ->fields($fields);
      $pid = $query->execute();
    }
    catch (\Exception $e) {
      // If there was an exception, try to create the table.
      if (!$try_again = $this->ensureTableExists()) {
        // If the exception happened for other reason than the missing table,
        // propagate the exception.
        throw $e;
      }
    }
    // Now that the table has been created, try again if necessary.
    if ($try_again) {
      $query = $this->connection->insert(static::TABLE)
        ->fields($fields);
      $pid = $query->execute();
    }

    $fields['pid'] = $pid;
    $operation = 'insert';
  }
  else {
    // Fetch the current values so that an update hook can identify what
    // exactly changed.
    try {
      $original = $this->connection->query('SELECT source, alias, langcode FROM {url_alias} WHERE pid = :pid', array(':pid' => $pid))
        ->fetchAssoc();
    }
    catch (\Exception $e) {
      $this->catchException($e);
      $original = FALSE;
    }
    $fields['pid'] = $pid;
    $query = $this->connection->update(static::TABLE)
      ->fields($fields)
      ->condition('pid', $pid);
    $pid = $query->execute();
    $fields['original'] = $original;
    $operation = 'update';
  }
  if ($pid) {
    // @todo Switch to using an event for this instead of a hook.
    $this->moduleHandler->invokeAll('path_' . $operation, array($fields));
    Cache::invalidateTags(['route_match']);
    return $fields;
  }
  return FALSE;
}