class AliasStorage
Provides a class for CRUD operations on path aliases.
All queries perform case-insensitive matching on the 'source' and 'alias' fields, so the aliases '/test-alias' and '/test-Alias' are considered to be the same, and will both refer to the same internal system path.
Hierarchy
- class \Drupal\Core\Path\AliasStorage implements \Drupal\Core\Path\AliasStorageInterface
Expanded class hierarchy of AliasStorage
Deprecated
\Drupal\Core\Path\AliasStorage is deprecated in drupal:8.8.0 and is removed from drupal:9.0.0. Use the "path_alias.repository" service instead, or the entity storage handler for the "path_alias" entity type for CRUD methods.
See also
https://www.drupal.org/node/3013865
1 string reference to 'AliasStorage'
- core.services.yml in core/
core.services.yml - core/core.services.yml
1 service uses AliasStorage
File
-
core/
lib/ Drupal/ Core/ Path/ AliasStorage.php, line 28
Namespace
Drupal\Core\PathView source
class AliasStorage implements AliasStorageInterface {
/**
* The table for the url_alias storage.
*/
const TABLE = 'path_alias';
/**
* The database connection.
*
* @var \Drupal\Core\Database\Connection
*/
protected $connection;
/**
* The module handler.
*
* @var \Drupal\Core\Extension\ModuleHandlerInterface
*/
protected $moduleHandler;
/**
* The entity type manager.
*
* @var \Drupal\Core\Entity\EntityTypeManagerInterface
*/
protected $entityTypeManager;
/**
* Constructs a Path CRUD object.
*
* @param \Drupal\Core\Database\Connection $connection
* A database connection for reading and writing path aliases.
* @param \Drupal\Core\Extension\ModuleHandlerInterface $module_handler
* The module handler.
* @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
* The entity type manager.
*/
public function __construct(Connection $connection, ModuleHandlerInterface $module_handler, EntityTypeManagerInterface $entity_type_manager = NULL) {
$this->connection = $connection;
$this->moduleHandler = $module_handler;
$this->entityTypeManager = $entity_type_manager ?: \Drupal::entityTypeManager();
}
/**
* {@inheritdoc}
*/
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));
}
if ($pid) {
/** @var \Drupal\path_alias\PathAliasInterface $path_alias */
$path_alias = $this->getPathAliasEntityStorage()
->load($pid);
$original_values = [
'source' => $path_alias->getPath(),
'alias' => $path_alias->getAlias(),
'langcode' => $path_alias->get('langcode')->value,
];
$path_alias->setPath($source);
$path_alias->setAlias($alias);
$path_alias->set('langcode', $langcode);
}
else {
$path_alias = $this->getPathAliasEntityStorage()
->create([
'path' => $source,
'alias' => $alias,
'langcode' => $langcode,
]);
}
$path_alias->save();
$path_alias_values = [
'pid' => $path_alias->id(),
'source' => $path_alias->getPath(),
'alias' => $path_alias->getAlias(),
'langcode' => $path_alias->get('langcode')->value,
];
if (isset($original_values)) {
$path_alias_values['original'] = $original_values;
}
return $path_alias_values;
}
/**
* {@inheritdoc}
*/
public function load($conditions) {
$query = $this->getPathAliasEntityStorage()
->getQuery();
// Ignore access restrictions for this API.
$query->accessCheck(FALSE);
foreach ($conditions as $field => $value) {
if ($field === 'source') {
$field = 'path';
}
elseif ($field === 'pid') {
$field = 'id';
}
$query->condition($field, $value, '=');
}
$result = $query->sort('id', 'DESC')
->range(0, 1)
->execute();
$entities = $this->getPathAliasEntityStorage()
->loadMultiple($result);
/** @var \Drupal\path_alias\PathAliasInterface $path_alias */
$path_alias = reset($entities);
if ($path_alias) {
return [
'pid' => $path_alias->id(),
'source' => $path_alias->getPath(),
'alias' => $path_alias->getAlias(),
'langcode' => $path_alias->get('langcode')->value,
];
}
return FALSE;
}
/**
* {@inheritdoc}
*/
public function delete($conditions) {
$storage = $this->getPathAliasEntityStorage();
$query = $storage->getQuery();
// API functions should be able to access all entities regardless of access
// restrictions. Those need to happen on a higher level.
$query->accessCheck(FALSE);
foreach ($conditions as $field => $value) {
if ($field === 'source') {
$field = 'path';
}
elseif ($field === 'pid') {
$field = 'id';
}
$query->condition($field, $value, '=');
}
$result = $query->execute();
$storage->delete($storage->loadMultiple($result));
}
/**
* Returns a SELECT query for the path_alias base table.
*
* @return \Drupal\Core\Database\Query\SelectInterface
* A Select query object.
*/
protected function getBaseQuery() {
$query = $this->connection
->select(static::TABLE, 'base_table');
$query->condition('base_table.status', 1);
return $query;
}
/**
* {@inheritdoc}
*/
public function preloadPathAlias($preloaded, $langcode) {
$select = $this->getBaseQuery()
->fields('base_table', [
'path',
'alias',
]);
if (!empty($preloaded)) {
$conditions = new Condition('OR');
foreach ($preloaded as $preloaded_item) {
$conditions->condition('base_table.path', $this->connection
->escapeLike($preloaded_item), 'LIKE');
}
$select->condition($conditions);
}
$this->addLanguageFallback($select, $langcode);
// We order by ID ASC so that fetchAllKeyed() returns the most recently
// created alias for each source. Subsequent queries using fetchField() must
// use ID DESC to have the same effect.
$select->orderBy('base_table.id', 'ASC');
return $select->execute()
->fetchAllKeyed();
}
/**
* {@inheritdoc}
*/
public function lookupPathAlias($path, $langcode) {
// See the queries above. Use LIKE for case-insensitive matching.
$select = $this->getBaseQuery()
->fields('base_table', [
'alias',
])
->condition('base_table.path', $this->connection
->escapeLike($path), 'LIKE');
$this->addLanguageFallback($select, $langcode);
$select->orderBy('base_table.id', 'DESC');
return $select->execute()
->fetchField();
}
/**
* {@inheritdoc}
*/
public function lookupPathSource($alias, $langcode) {
// See the queries above. Use LIKE for case-insensitive matching.
$select = $this->getBaseQuery()
->fields('base_table', [
'path',
])
->condition('base_table.alias', $this->connection
->escapeLike($alias), 'LIKE');
$this->addLanguageFallback($select, $langcode);
$select->orderBy('base_table.id', 'DESC');
return $select->execute()
->fetchField();
}
/**
* Adds path alias language fallback conditions to a select query object.
*
* @param \Drupal\Core\Database\Query\SelectInterface $query
* A Select query object.
* @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.
*/
protected function addLanguageFallback(SelectInterface $query, $langcode) {
// Always get the language-specific alias before the language-neutral one.
// For example 'de' is less than 'und' so the order needs to be ASC, while
// 'xx-lolspeak' is more than 'und' so the order needs to be DESC.
$langcode_list = [
$langcode,
LanguageInterface::LANGCODE_NOT_SPECIFIED,
];
if ($langcode === LanguageInterface::LANGCODE_NOT_SPECIFIED) {
array_pop($langcode_list);
}
elseif ($langcode > LanguageInterface::LANGCODE_NOT_SPECIFIED) {
$query->orderBy('base_table.langcode', 'DESC');
}
else {
$query->orderBy('base_table.langcode', 'ASC');
}
$query->condition('base_table.langcode', $langcode_list, 'IN');
}
/**
* {@inheritdoc}
*/
public function aliasExists($alias, $langcode, $source = NULL) {
// Use LIKE and NOT LIKE for case-insensitive matching.
$query = $this->connection
->select(static::TABLE)
->condition('alias', $this->connection
->escapeLike($alias), 'LIKE')
->condition('langcode', $langcode);
if (!empty($source)) {
$query->condition('path', $this->connection
->escapeLike($source), 'NOT LIKE');
}
$query->addExpression('1');
$query->range(0, 1);
return (bool) $query->execute()
->fetchField();
}
/**
* {@inheritdoc}
*/
public function languageAliasExists() {
return (bool) $this->connection
->queryRange('SELECT 1 FROM {' . static::TABLE . '} WHERE langcode <> :langcode', 0, 1, [
':langcode' => LanguageInterface::LANGCODE_NOT_SPECIFIED,
])
->fetchField();
}
/**
* {@inheritdoc}
*/
public function getAliasesForAdminListing($header, $keys = NULL) {
$query = $this->connection
->select(static::TABLE)
->extend('Drupal\\Core\\Database\\Query\\PagerSelectExtender')
->extend('Drupal\\Core\\Database\\Query\\TableSortExtender');
if ($keys) {
// Replace wildcards with PDO wildcards.
$query->condition('alias', '%' . preg_replace('!\\*+!', '%', $keys) . '%', 'LIKE');
}
$query->addField(static::TABLE, 'id', 'pid');
$query->addField(static::TABLE, 'path', 'source');
return $query->fields(static::TABLE, [
'alias',
'langcode',
])
->orderByHeader($header)
->limit(50)
->execute()
->fetchAll();
}
/**
* {@inheritdoc}
*/
public function pathHasMatchingAlias($initial_substring) {
if (!$this->moduleHandler
->moduleExists('path_alias')) {
return FALSE;
}
$query = $this->getBaseQuery();
$query->addExpression(1);
return (bool) $query->condition('base_table.path', $this->connection
->escapeLike($initial_substring) . '%', 'LIKE')
->range(0, 1)
->execute()
->fetchField();
}
/**
* Returns the path alias entity storage handler.
*
* We can not store it in the constructor because that leads to a circular
* dependency in the service container.
*
* @return \Drupal\Core\Entity\EntityStorageInterface
* The path alias entity storage.
*/
protected function getPathAliasEntityStorage() {
return $this->entityTypeManager
->getStorage('path_alias');
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|
AliasStorage::$connection | protected | property | The database connection. | |
AliasStorage::$entityTypeManager | protected | property | The entity type manager. | |
AliasStorage::$moduleHandler | protected | property | The module handler. | |
AliasStorage::addLanguageFallback | protected | function | Adds path alias language fallback conditions to a select query object. | |
AliasStorage::aliasExists | public | function | Checks if alias already exists. | Overrides AliasStorageInterface::aliasExists |
AliasStorage::delete | public | function | Deletes a URL alias. | Overrides AliasStorageInterface::delete |
AliasStorage::getAliasesForAdminListing | public | function | Loads aliases for admin listing. | Overrides AliasStorageInterface::getAliasesForAdminListing |
AliasStorage::getBaseQuery | protected | function | Returns a SELECT query for the path_alias base table. | |
AliasStorage::getPathAliasEntityStorage | protected | function | Returns the path alias entity storage handler. | |
AliasStorage::languageAliasExists | public | function | Checks if there are any aliases with language defined. | Overrides AliasStorageInterface::languageAliasExists |
AliasStorage::load | public | function | Fetches a specific URL alias from the database. | Overrides AliasStorageInterface::load |
AliasStorage::lookupPathAlias | public | function | Returns an alias of Drupal system URL. | Overrides AliasStorageInterface::lookupPathAlias |
AliasStorage::lookupPathSource | public | function | Returns Drupal system URL of an alias. | Overrides AliasStorageInterface::lookupPathSource |
AliasStorage::pathHasMatchingAlias | public | function | Check if any alias exists starting with $initial_substring. | Overrides AliasStorageInterface::pathHasMatchingAlias |
AliasStorage::preloadPathAlias | public | function | Pre-loads path alias information for a given list of source paths. | Overrides AliasStorageInterface::preloadPathAlias |
AliasStorage::save | public | function | Saves a path alias to the database. | Overrides AliasStorageInterface::save |
AliasStorage::TABLE | constant | The table for the url_alias storage. | ||
AliasStorage::__construct | public | function | Constructs a Path CRUD object. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.