Magento 2 URL重写再生扩展安装与使用指南
本指南将引导您完成在Magento 2中安装和使用olegkoval/magento2-regenerate_url_rewrites扩展的过程。此扩展通过命令行界面提供了重新生成产品和分类URL重写的功能。
1. 项目目录结构及介绍
该扩展遵循Magento 2的标准模块结构。以下是其主要目录及其简介:
- app/code/OlegKoval/RegenerateUrlRewrites
- Controller: 包含用于执行URL重写再生逻辑的CLI控制器。
- Model: 实现具体业务逻辑,如URL重写的处理。
- etc: 配置文件所在目录,包括模块的声明和CLI配置。
- Helper: 辅助类,提供辅助功能。
- Console: CLI命令的具体实现部分。
- view: 尽管是CLI扩展,但通常为空或包含非前端相关资源。
- registration.php: 注册模块到Magento 2系统。
- composer.json: 模块的Composer配置文件,定义依赖和版本信息。
2. 项目的启动文件介绍
CLI命令启动
项目的关键“启动点”是通过命令行接口执行的命令。要再生URL重写,您将运行以下命令:
$ bin/magento ok:urlrewrites:regenerate
这个命令位于Controller/Console/Regenerate.php
,它被设计用来触发整个URL重写再生过程。您可以针对所有店铺或特定店铺视图进行操作。
3. 项目的配置文件介绍
配置并不直接涉及日常使用的可调整设置,但在模块层面,关键的配置位于:
- etc/module.xml: 定义了模块的基础信息,如模块名称、版本等,使Magento识别该模块。
- etc/di.xml: 可能用于定义依赖注入规则。
- etc/cli.xml: 特别重要,因为它包含了CLI命令的配置,使得
ok:urlrewrites:regenerate
这样的命令能够被系统识别并执行。 - dev/config.php: 注意,虽然不是所有模块都涉及到,但对于开发环境,可能会影响模块的开发时配置。
安装和启用该扩展,以及配置和使用它主要是通过Composer安装、Magento命令行来管理,并通过上述提及的CLI命令来执行实际的URL重写再生任务。
安装步骤概览
-
** Composer安装**: 在Magento 2根目录下运行:
$ composer require olegkoval/magento2-regenerate-url-rewrites
-
启用模块:
$ php bin/magento module:enable OlegKoval_RegenerateUrlRewrites
-
部署静态内容和编译代码(若有必要):
$ php bin/magento setup:upgrade $ php bin/magento cache:flush $ php bin/magento setup:static-content:deploy -f $ php bin/magento setup:di:compile
至此,您已成功安装并准备使用该扩展来再生您的Magento 2网站的URL重写了。请注意,实际操作前最好备份数据库,以防不测。