Pathauto的局限性
在drupal网站开发中，pathauto模块是管理url别名的首选工具，它能够根据预设模式自动为内容、用户等实体生成友好的url路径。然而，pathauto的核心设计理念是为每个实体生成一个唯一的、规范的url别名。当业务需求要求为同一个节点（node）生成两个或更多不同的url别名时，pathauto便无法直接满足。例如，一个产品页面可能需要同时通过/products/product-name和/deals/product-name访问。在这种情况下，我们需要借助drupal的编程能力来实现。
自定义模块实现多URL别名
Drupal允许一个节点拥有任意数量的URL别名。虽然Pathauto无法自动生成多个别名，但我们可以通过编写一个简单的自定义模块，利用Drupal的实体API和钩子机制来在节点创建时动态生成并保存额外的别名。
1. 选择合适的钩子
为了在节点创建时触发别名生成逻辑，最合适的钩子是hook_entity_insert()。当任何实体（包括节点）被首次保存到数据库时，此钩子会被调用。
2. 构建自定义模块
首先，创建一个基本的Drupal自定义模块。假设我们的模块名为mymultialias。
模块结构示例：
mymultialias/ ├── mymultialias.info.yml └── mymultialias.module
mymultialias.info.yml文件内容：
name: 'My Multi Alias' type: module description: 'Provides functionality to generate multiple aliases for a single node.' core_version_requirement: ^9 || ^10 package: 'Custom'
mymultialias.module文件内容：
在该文件中，我们将实现hook_entity_insert()钩子。
<?php
/**
* @file
* Primary module hooks for My Multi Alias module.
*/
use Drupal\Core\Entity\EntityInterface;
use Drupal\path_alias\Entity\PathAlias;
/**
* Implements hook_entity_insert().
*
* This hook is invoked after a new entity has been inserted.
*/
function mymultialias_entity_insert(EntityInterface $entity) {
// 确保我们处理的是节点实体，并且它有一个有效的URL。
if ($entity->getEntityTypeId() === 'node' && $entity->hasLinkTemplate('canonical')) {
/** @var \Drupal\node\NodeInterface $node */
$node = $entity;
// 获取节点的默认规范路径。
// 这通常是 /node/{nid}，Pathauto会基于此生成第一个别名。
$source_path = '/node/' . $node->id();
// 示例：生成第二个别名。
// 假设我们想要一个基于节点标题的别名，前缀为 '/special-path/'。
// 在实际应用中，您可能需要更复杂的逻辑来构建别名。
$title_slug = \Drupal::transliteration()->transliterate($node->getTitle(), 'en', '_');
$title_slug = mb_strtolower(preg_replace('/[^a-z0-9_]+/', '-', $title_slug));
$additional_alias_path = '/special-path/' . $title_slug;
// 检查此别名是否已存在，避免重复。
$existing_alias = \Drupal::service('path_alias.repository')->lookupPathAlias($source_path, 'en');
if ($existing_alias === $additional_alias_path) {
// 如果Pathauto已经生成了我们想要的别名，则无需额外操作。
return;
}
// 检查新的别名路径是否已经被占用。
$path_alias_manager = \Drupal::service('path_alias.manager');
$is_alias_taken = $path_alias_manager->getPathByAlias($additional_alias_path);
if ($is_alias_taken !== $additional_alias_path && $is_alias_taken !== $source_path) {
// 创建并保存新的PathAlias实体。
$path_alias = PathAlias::create([
'path' => $source_path,
'alias' => $additional_alias_path,
'langcode' => $node->get('langcode')->value,
]);
$path_alias->save();
\Drupal::logger('mymultialias')->notice('Generated additional alias %alias for node %nid.', [
'%alias' => $additional_alias_path,
'%nid' => $node->id(),
]);
} else {
\Drupal::logger('mymultialias')->warning('Could not generate additional alias %alias for node %nid as it is already in use or matches the primary alias.', [
'%alias' => $additional_alias_path,
'%nid' => $node->id(),
]);
}
}
}代码说明：
- mymultialias_entity_insert(EntityInterface $entity): 这是钩子的实现，$entity参数是刚刚创建的实体对象。
- $entity-youjiankuohaophpcngetEntityTypeId() === 'node': 确保我们只处理节点实体。
- $source_path = '/node/' . $node->id();: 这是节点的内部路径，所有别名都将指向此内部路径。
- $additional_alias_path = '/special-path/' . $title_slug;: 这是我们自定义的第二个别名路径。您可以根据需求修改生成逻辑。
- \Drupal::service('path_alias.repository')->lookupPathAlias($source_path, 'en'): 用于查找给定源路径的当前别名。
- \Drupal::service('path_alias.manager')->getPathByAlias($additional_alias_path): 用于检查一个别名路径是否已经被占用，或者它指向的源路径是什么。
- PathAlias::create([...])->save(): 这是创建并保存新的URL别名的关键步骤。它需要path（内部源路径）、alias（新的别名路径）和langcode（语言代码）。
3. 启用模块
将mymultialias文件夹放置在Drupal站点的modules/custom目录下，然后通过Drupal管理界面（/admin/modules）启用该模块。
现在，每当创建一个新的节点时，除了Pathauto生成的默认别名外，您的自定义模块也会尝试生成并保存一个额外的别名。
SEO考量与注意事项
在为单个节点生成多个URL别名时，务必谨慎考虑SEO（搜索引擎优化）方面的影响。
-
重复内容问题： 搜索引擎（如Google）通常不喜欢“重复内容”。当多个URL指向完全相同的内容时，搜索引擎可能会认为这是重复内容，这可能导致：
- 排名下降： 搜索引擎可能不知道哪个URL是“权威”的，从而分散了页面的排名信号。
- 索引问题： 搜索引擎可能只索引其中一个URL，而忽略其他URL。
- 信任度降低： 频繁的重复内容可能影响网站的整体信任度。
-
解决方案：
- rel="canonical"标签： 这是处理重复内容最推荐的方法。在页面的HTML头部添加一个<link rel="canonical" href="[规范URL]"/>标签，明确告诉搜索引擎哪个URL是该内容的“主”版本。即使有多个别名，canonical标签也应该始终指向你希望搜索引擎索引和排名的那个URL。Drupal通常会为节点自动生成规范URL，但如果您的自定义别名策略导致了非规范URL被广泛使用，您可能需要确保canonical标签指向的是Pathauto生成的主别名或您指定的首选别名。
- 301重定向： 如果某个别名只是临时性的，或者您希望将旧的或不常用的别名永久性地指向一个规范URL，可以使用301重定向。这意味着当用户或搜索引擎访问旧别名时，会被自动引导到新别名。这可以通过Drupal的重定向模块（Redirect）或自定义代码实现。
- 避免过度使用： 除非有非常明确的业务需求，否则应尽量避免为单个页面创建过多的别名。保持URL结构简洁和规范对用户体验和SEO都有益。
在实施多别名策略前，请务必仔细评估其对网站SEO的潜在影响，并采取适当的措施来避免重复内容问题。
总结
通过自定义Drupal模块并利用hook_entity_insert钩子，我们可以轻松地突破Pathauto的限制，为单个节点自动生成多个URL别名。这种方法提供了极大的灵活性，以满足特定的业务需求。然而，在享受这种灵活性的同时，开发者必须高度重视SEO方面的挑战，特别是重复内容问题。通过正确使用rel="canonical"标签，并在必要时考虑301重定向，可以有效管理这些风险，确保网站的搜索引擎表现不受影响。始终建议在开发环境中充分测试所有自定义代码，并在上线前进行彻底的SEO审查。
