文档Commerce安装指南

卸载模块

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined
  • undefined
  • undefined

本节讨论如何卸载一个或多个模块。 在卸载过程中，可以选择删除模块的代码、数据库架构和数据库数据。 您可以先创建备份，以便以后恢复数据。

只有在您确定不会使用某个模块时，才应卸载该模块。 您可以按照启用或禁用模块中的说明禁用模块，而不是卸载模块。

NOTE
此命令仅检查在composer.json文件中声明的依赖项。 如果您卸载的模块不是composer.json文件中定义的​_和_，此命令将卸载该模块而不检查依赖关系。 此命令​_不_，但是，请从文件系统中删除模块的代码。 必须使用文件系统工具删除模块的代码（例如，rm -rf <path to module>）。 作为替代方法，您可以禁用非编辑器模块。

命令用法：

bin/magento module:uninstall [--backup-code] [--backup-media] [--backup-db] [-r|--remove-data] [-c|--clear-static-content] \
  {ModuleName} ... {ModuleName}

其中{ModuleName}以<VendorName>_<ModuleName>格式指定模块名称。 例如，客户模块名称为Magento_Customer。 要获取模块名称列表，请输入magento module:status

模块uninstall命令执行以下任务：

  1. 验证指定的模块是否存在于代码库中，以及是否由Composer安装的包。

    此命令只对定义为Composer包的模块起作用​ 1}。

  2. 检查与其他模块的依赖关系，如果存在任何未满足的依赖关系，则终止该命令。

    要解决此问题，您可以同时卸载所有模块，也可以先卸载相关模块。

  3. 请求确认以继续。

  4. 将商店置于维护模式。

  5. 处理以下命令选项。

    table 0-row-3 1-row-3 2-row-3 3-row-3
    选项 含义 备份文件名和位置
    --backup-code 备份文件系统（不包括var和pub/static目录）。 var/backups/<timestamp>_filesystem.tgz
    --backup-media 备份pub/media目录。 var/backups/<timestamp>_filesystem_media.tgz
    --backup-db 备份数据库。 var/backups/<timestamp>_db.gz

  6. 如果指定了--remove-data，则删除在模块的Uninstall类中定义的数据库架构和数据。

    对于要卸载的每个指定模块，调用其Uninstall类中的uninstall方法。 此类必须继承自Magento\Framework\Setup\UninstallInterface。

  7. 从setup_module数据库表中删除指定的模块。

  8. 从部署配置的模块列表中删除指定的模块。

  9. 使用composer remove从代码库中移除代码。

    note note
    NOTE
    卸载模块​_始终_​运行composer remove。 --remove-data选项将删除由模块的Uninstall类定义的数据库数据和架构。

  10. 清理缓存。

  11. 更新生成的类。

  12. 如果指定了--clear-static-content，则清理生成的静态视图文件。

  13. 使存储退出维护模式。

例如，如果您尝试卸载另一个模块所依赖的模块，则会显示以下消息：

magento module:uninstall Magento_SampleMinimal
    Cannot uninstall module 'Magento_SampleMinimal' because the following module(s) depend on it:
        Magento_SampleModifyContent

另一种选择是在备份模块文件系统、pub/media文件和数据库表但​ 不 ​删除模块的数据库架构或数据之后卸载这两个模块：

bin/magento module:uninstall Magento_SampleMinimal Magento_SampleModifyContent --backup-code --backup-media --backup-db

与以下内容类似的消息：

You are about to remove code and/or database tables. Are you sure?[y/N]y
Enabling maintenance mode
Code backup is starting...
Code backup filename: 1435261098_filesystem_code.tgz (The archive can be uncompressed with 7-Zip on Windows systems)
Code backup path: /var/www/html/magento2/var/backups/1435261098_filesystem_code.tgz
[SUCCESS]: Code backup completed successfully.
Media backup is starting...
Media backup filename: 1435261098_filesystem_media.tgz (The archive can be uncompressed with 7-Zip on Windows systems)
Media backup path: /var/www/html/magento2/var/backups/1435261098_filesystem_media.tgz
[SUCCESS]: Media backup completed successfully.
DB backup is starting...
DB backup filename: 1435261098_db.gz (The archive can be uncompressed with 7-Zip on Windows systems)
DB backup path: /var/www/html/magento2/var/backups/1435261098_db.gz
[SUCCESS]: DB backup completed successfully.
You are about to remove a module(s) that might have database data. Remove the database data manually after uninstalling, if desired.
Removing Magento_SampleMinimal, Magento_SampleModifyContent from module registry in database
Removing Magento_SampleMinimal, Magento_SampleModifyContent from module list in deployment configuration
Removing code from Magento codebase:
Loading composer repositories with package information
Updating dependencies (including require-dev)
  - Removing magento/sample-module-modifycontent (1.0.0)
Removing Magento/SampleModifycontent
  - Removing magento/sample-module-minimal (1.0.0)
Removing Magento/SampleMinimal
Writing lock file
Generating autoload files
Cache cleared successfully.
Generated classes cleared successfully.
Alert: Generated static view files were not cleared. You can clear them using the --clear-static-content option. Failure to clear static view files might cause display issues in the Admin and storefront.
Disabling maintenance mode
NOTE
如果尝试卸载与另一模块具有依赖关系的模块，则会显示错误。 在这种情况下，无法卸载一个模块；必须同时卸载这两个模块。

回滚文件系统、数据库或媒体文件

要将代码库恢复到备份时的状态，请使用以下命令：

bin/magento setup:rollback [-c|--code-file="<filename>"] [-m|--media-file="<filename>"] [-d|--db-file="<filename>"]

其中<filename>是<app_root>/var/backups目录中的备份文件的名称。 要显示备份文件列表，请输入magento info:backups:list

WARNING
此命令在还原指定文件或数据库之前删除它们。 例如，--media-file选项会先删除pub/media目录下的媒体资产，然后再从指定的回滚文件还原。 使用此命令之前，请确保未更改要保留的文件系统或数据库。
NOTE
要显示可用备份文件列表，请输入magento info:backups:list

此命令执行以下任务：

  1. 将商店置于维护模式。

  2. 验证备份文件名。

  3. 如果指定代码回滚文件：

    a.验证回滚目标位置是否可写（请注意，pub/static和var文件夹将被忽略）。

    b.删除应用程序安装目录下的所有文件和目录。

    c.将存档文件提取到目标位置。

  4. 如果指定数据库回滚文件：

    a.删除整个数据库。

    b.使用数据库备份还原数据库。

  5. 如果指定介质回滚文件：

    a.验证回滚目标位置是否可写。

    b.删除pub/media下的所有文件和目录

    c.将存档文件提取到目标位置。

  6. 使存储退出维护模式。

例如，要恢复代码（即文件系统）备份，请按照显示的顺序输入以下命令：

  • 显示备份列表：

    code language-bash 
    magento info:backups:list

  • 还原名为1433876616_filesystem.tgz的文件备份：

    code language-bash 
    magento setup:rollback --code-file="1433876616_filesystem.tgz"

    与以下内容类似的消息：

    code language-none 
    Enabling maintenance mode
Code rollback is starting ...
Code rollback filename: 1433876616_filesystem.tgz
Code rollback file path: /var/www/html/magento2/var/backups/1433876616_filesystem.tgz
[SUCCESS]: Code rollback has completed successfully.
Disabling maintenance mode
NOTE
要再次运行magento命令而不更改目录，可能需要输入cd pwd。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995