interface AliasStorageHelperInterface in Pathauto 8

Provides helper methods for accessing alias storage.

@internal This interface is internal to pathauto, it abstracts direct alias storage access as well as backwards-compatibility for 8.7 and will be refactored.

Hierarchy

• interface \Drupal\pathauto\AliasStorageHelperInterface

3 files declare their use of AliasStorageHelperInterface

PathautoAdminDelete.php in src/Form/PathautoAdminDelete.php

PathautoCommands.php in src/Commands/PathautoCommands.php

PathautoSettingsForm.php in src/Form/PathautoSettingsForm.php

File

src/AliasStorageHelperInterface.php, line 15

Namespace

Drupal\pathauto

interface AliasStorageHelperInterface {

  /**
   * Fetch the maximum length of the {path_alias}.alias field from the schema.
   *
   * @return int
   *   An integer of the maximum URL alias length allowed by the database.
   */
  public function getAliasSchemaMaxLength();

  /**
   * Private function for Pathauto to create an alias.
   *
   * @param array $path
   *   An associative array containing the following keys:
   *   - source: The internal system path.
   *   - alias: The URL alias.
   *   - pid: (optional) Unique path alias identifier.
   *   - language: (optional) The language of the alias.
   * @param array|bool|null $existing_alias
   *   (optional) An associative array of the existing path alias.
   * @param string $op
   *   An optional string with the operation being performed.
   *
   * @return array|bool
   *   The saved path or NULL if the path was not saved.
   */
  public function save(array $path, $existing_alias = NULL, $op = NULL);

  /**
   * Fetches an existing URL alias given a path and optional language.
   *
   * @param string $source
   *   An internal Drupal path.
   * @param string $language
   *   An optional language code to look up the path in.
   *
   * @return bool|array
   *   FALSE if no alias was found 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.
   */
  public function loadBySource($source, $language = LanguageInterface::LANGCODE_NOT_SPECIFIED);

  /**
   * Delete all aliases by source url.
   *
   * @param string $source
   *   An internal Drupal path.
   *
   * @return bool
   *   The URL alias source.
   */
  public function deleteBySourcePrefix($source);

  /**
   * Delete all aliases (truncate the path alias entity tables).
   */
  public function deleteAll();

  /**
   * Delete an entity URL alias and any of its sub-paths.
   *
   * This function also checks to see if the default entity URI is different
   * from the current entity URI and will delete any of the default aliases.
   *
   * @param \Drupal\Core\Entity\EntityInterface $entity
   *   An entity object.
   * @param string $default_uri
   *   The optional default uri path for the entity.
   */
  public function deleteEntityPathAll(EntityInterface $entity, $default_uri = NULL);

  /**
   * Fetches an existing URL alias given a path prefix.
   *
   * @param string $source
   *   An internal Drupal path prefix.
   *
   * @return integer[]
   *   An array of PIDs.
   */
  public function loadBySourcePrefix($source);

  /**
   * Returns the count of url aliases for the source.
   *
   * @param $source
   *   An internal Drupal path prefix.
   *
   * @return int
   *   Number of url aliases for the source.
   */
  public function countBySourcePrefix($source);

  /**
   * Returns the total count of the url aliases.
   *
   * @return int
   *   Total number of aliases.
   */
  public function countAll();

  /**
   * Delete multiple URL aliases.
   *
   * Intent of this is to abstract a potential path_delete_multiple() function
   * for Drupal 7 or 8.
   *
   * @param int[] $pids
   *   An array of path IDs to delete.
   */
  public function deleteMultiple($pids);

}

Members

Name	Modifiers	Type	Description	Overrides
AliasStorageHelperInterface::countAll	public	function	Returns the total count of the url aliases.	1
AliasStorageHelperInterface::countBySourcePrefix	public	function	Returns the count of url aliases for the source.	1
AliasStorageHelperInterface::deleteAll	public	function	Delete all aliases (truncate the path alias entity tables).	1
AliasStorageHelperInterface::deleteBySourcePrefix	public	function	Delete all aliases by source url.	1
AliasStorageHelperInterface::deleteEntityPathAll	public	function	Delete an entity URL alias and any of its sub-paths.	1
AliasStorageHelperInterface::deleteMultiple	public	function	Delete multiple URL aliases.	1
AliasStorageHelperInterface::getAliasSchemaMaxLength	public	function	Fetch the maximum length of the {path_alias}.alias field from the schema.	1
AliasStorageHelperInterface::loadBySource	public	function	Fetches an existing URL alias given a path and optional language.	1
AliasStorageHelperInterface::loadBySourcePrefix	public	function	Fetches an existing URL alias given a path prefix.	1
AliasStorageHelperInterface::save	public	function	Private function for Pathauto to create an alias.	1