Magento2商店URL乱了？Elgentos可以帮你批量重塑！-composer-PHP中文网

Magento2商店URL乱了？Elgentos可以帮你批量重塑！

PHPz

发布： 2025-06-23 09:48:47

原创

420人浏览过

在使用 Magento 2 构建电商网站时，经常会遇到 URL 相关的问题，例如产品 URL 路径不正确、分类 URL 无法访问、CMS 页面链接失效等等。手动一个个修改既耗时又容易出错。elgentos/regenerate-catalog-urls 扩展提供了一组便捷的命令行工具，可以批量重新生成产品、分类和 CMS 页面的 URL，极大地提高了维护效率。 Composer在线学习地址：学习地址

这个扩展能做什么？

elgentos/regenerate-catalog-urls 扩展为 Magento 2 添加了一系列命令行工具，用于重新生成：

产品 URL Rewrite: 基于产品的 URL 路径重新生成 URL Rewrite。
分类 URL Rewrite: 基于分类的 URL 路径重新生成 URL Rewrite。
CMS 页面 URL Rewrite: 基于 CMS 页面的 URL 路径重新生成 URL Rewrite。
分类 URL Path: 基于分类的 URL Key 及其父级分类重新生成分类 URL 路径。

安装

安装非常简单，只需通过 Composer 即可：

composer require elgentos/regenerate-catalog-urls
php bin/magento setup:upgrade

登录后复制

或者，你也可以下载源码，将 src 目录复制到 app/code/Elgentos/RegenerateCatalogUrls，然后运行 php bin/magento setup:upgrade。

使用方法

该扩展提供了多个命令行指令，可以通过 php bin/magento 命令调用：

Usage:
 regenerate:product:url [-s|--store="..."] [pids1] ... [pidsN]
 regenerate:category:url [-s|--store="..."] [-r|--root="..."] [cids1] ... [cidsN]
 regenerate:category:path [-s|--store="..."] [-r|--root="..."] [cids1] ... [cidsN]
 regenerate:cms-page:url [-s|--store="..."] [pids1] ... [pidsN]

Arguments:
 pids                  Products (or Pages) to regenerate
 cids                  Categories to regenerate

Options:
 --store (-s)          Use a specific store (store Id, store code or 'all')
 --root (-r)           Regenerate for root category and its children, ignoring cids.
 --verbose (-v)        Verbose mode to display the errors. Eg: duplicated product urls
 --help (-h)           Display this help message

登录后复制

示例：

重新生成所有产品在全局商店中的 URL：
```
php bin/magento regenerate:product:url
```
登录后复制
重新生成 ID 为 1, 2, 3, 4 的产品在商店 1 中的 URL：
```
php bin/magento regenerate:product:url -s1 1 2 3 4
```
登录后复制
重新生成所有 CMS 页面的 URL：
```
php bin/magento regenerate:cms-page:url -s all
```
登录后复制
重新生成根分类 ID 为 4 及其子分类在商店 1 中的 URL：
```
php bin/magento regenerate:category:url -s1 -r4
```
登录后复制

常见问题 (FAQ)

url_key 和 url_path 有什么区别？

url_key 包含关键字，例如 "joust-duffle-bag"。url_path 是通过将 url_key 添加后缀生成的 (产品后缀存储在 catalog/seo/product_url_suffix 中，默认为 .html)。因此，url_path 默认会变成 joust-duffle-bag.html。它还会添加父级分类的 slug，因此 url_path 可能会变成 bags/joust-duffle-bag.html。但是，自 Magento 2.1 版本早期以来，url_path 的使用已被弃用。如果你运行的是最新的 Magento 2 版本，可以安全地删除这些值。
运行命令时出现 "Duplicated url" 警告？

如果看到此错误，则表示 catalog_product_entity_varchar 中存在重复的 url_key 值 (在同一商店中)。可以使用 baldwin/magento2-module-url-data-integrity-checker 扩展来检查这些值 (需要手动修复)。

优势和实际应用

elgentos/regenerate-catalog-urls 扩展的优势在于：