interface AliasRepositoryInterface in Drupal 8

Provides an interface for path alias lookup operations.

Hierarchy

• interface \Drupal\Core\Path\AliasRepositoryInterface

Deprecated

in drupal:8.8.0 and is removed from drupal:9.0.0. Use \Drupal\path_alias\AliasRepositoryInterface.

See also

https://www.drupal.org/node/3092086

1 file declares its use of AliasRepositoryInterface

AliasRepositoryInterface.php in core/modules/path_alias/src/AliasRepositoryInterface.php

File

core/lib/Drupal/Core/Path/AliasRepositoryInterface.php, line 13

Namespace

Drupal\Core\Path

interface AliasRepositoryInterface {

  /**
   * Pre-loads path alias information for a given list of system paths.
   *
   * @param array $preloaded
   *   System paths that need preloading of aliases.
   * @param string $langcode
   *   Language code to search the path with. If there's no path defined for
   *   that language it will search paths without language.
   *
   * @return string[]
   *   System paths (keys) to alias (values) mapping.
   */
  public function preloadPathAlias($preloaded, $langcode);

  /**
   * Searches a path alias for a given Drupal system path.
   *
   * The default implementation performs case-insensitive matching on the
   * 'path' and 'alias' strings.
   *
   * @param string $path
   *   The system path to investigate for corresponding path aliases.
   * @param string $langcode
   *   Language code to search the path with. If there's no path defined for
   *   that language it will search paths without language.
   *
   * @return array|null
   *   An array containing the 'id', 'path', 'alias' and 'langcode' properties
   *   of a path alias, or NULL if none was found.
   */
  public function lookupBySystemPath($path, $langcode);

  /**
   * Searches a path alias for a given alias.
   *
   * The default implementation performs case-insensitive matching on the
   * 'path' and 'alias' strings.
   *
   * @param string $alias
   *   The alias to investigate for corresponding system paths.
   * @param string $langcode
   *   Language code to search the alias with. If there's no alias defined for
   *   that language it will search aliases without language.
   *
   * @return array|null
   *   An array containing the 'id', 'path', 'alias' and 'langcode' properties
   *   of a path alias, or NULL if none was found.
   */
  public function lookupByAlias($alias, $langcode);

  /**
   * Check if any alias exists starting with $initial_substring.
   *
   * @param string $initial_substring
   *   Initial system path substring to test against.
   *
   * @return bool
   *   TRUE if any alias exists, FALSE otherwise.
   */
  public function pathHasMatchingAlias($initial_substring);

}

Members

Name	Modifiers	Type	Description	Overrides
AliasRepositoryInterface::lookupByAlias	public	function	Searches a path alias for a given alias.	1
AliasRepositoryInterface::lookupBySystemPath	public	function	Searches a path alias for a given Drupal system path.	1
AliasRepositoryInterface::pathHasMatchingAlias	public	function	Check if any alias exists starting with $initial_substring.	1
AliasRepositoryInterface::preloadPathAlias	public	function	Pre-loads path alias information for a given list of system paths.	1