logo

额外区块类型 (EBT) - 全新的布局构建器体验❗

额外区块类型 (EBT) - 样式化、可定制的区块类型:幻灯片、标签页、卡片、手风琴等更多类型。内置背景、DOM Box、JavaScript 插件的设置。立即体验布局构建的未来。

演示 EBT 模块 下载 EBT 模块

❗额外段落类型 (EPT) - 全新的 Paragraphs 体验

额外段落类型 (EPT) - 类似的基于 Paragraph 的模块集合。

演示 EPT 模块 滚动

滚动

使用网页浏览器升级

01/10/2025, by Ivan

在您开始之前

在开始升级之前,请确保您已阅读本指南的前几页:

请确保您正在使用最新版本的 Drupal 8。您可以在 Drupal 8 站点的状态报告页面 (/admin/reports/status) 查看版本信息。迁移工具仍在开发中,因此请保持 Drupal 核心更新,以确保获得最新的迁移改进。

请确保您的 Drupal 8 站点启用了以下核心模块:

  • Migrate
  • Migrate Drupal
  • Migrate Drupal UI

安装并启用您希望从源站点迁移配置和内容所需的 Drupal 8 扩展模块。

定义源站点

  • 您可以访问 Drupal 8 站点的 /upgrade 路径来开始升级过程。如果您收到“页面未找到”错误,请确保已启用 “Migrate Drupal UI” 模块。
  • 定义源 Drupal 6/7 站点的数据库连接信息。如果源站点使用了数据库前缀,请展开高级选项并提供前缀。
  • 定义源站点的公开文件和私有文件目录,以便文件可以复制到 Drupal 8 站点。
  • 参见下方截图。

d8-upgrade-source-site

查看升级前分析

如果源数据库的凭据正确,您将看到升级概览页面,如下方截图所示。此页面显示旧站点已安装模块的升级状态摘要。

d8-upgrade-status-review-2

作为站点构建者,您需要仔细查看不会升级的模块。对于每个模块,请评估在 Drupal 8 中缺少该模块时站点是否仍能正常运行。以下是截图中几个模块的示例:

  • 地址字段 提供用于存储地址数据的字段类型。

- 如果继续升级,源站点中带有地址的节点将迁移到 Drupal 8 但不会包含地址,这可能不是您想要的结果。
- 解决方法是安装并启用 Drupal 8 的 Address 模块。
- 换句话说,在执行升级之前,您需要先安装缺失的 Drupal 8 模块,然后重新运行升级流程。此时,您将看到地址字段包含在可升级模块列表中。

  • Color —— Drupal 7 核心模块,用于轻松修改兼容主题的配色方案。

- 目前没有从 Drupal 7 Color 模块迁移配置参数到 Drupal 8 的升级路径。
- 不过您可以在升级完成后手动在 Drupal 8 中配置相关设置。
- 可以安全执行升级,但需注意 Drupal 7 Color 模块的配置不会自动迁移。

  • Views —— 允许创建各种内容列表。

- 即使启用了 Drupal 8 的 Views(已在核心中),在此处仍会显示为“未升级”。这是因为缺少自动迁移机制,无法将 Drupal 6/7 的 Views 配置迁移到 Drupal 8。
- 可以安全执行升级,但您需要在 Drupal 8 中手动重建 Views。

默认情况下,可升级模块的列表是折叠的。展开列表后,您可以查看最终将在新站点启用的模块。例如,原站点的 Block 模块会被拆分为 Drupal 8 中的两个模块。这只是信息展示,无法更改。

d8-upgrade-module-status-review-2

ID 冲突警告

升级准备部分所述,从 Drupal 6/7 升级到 Drupal 8 时,目标站点必须完全为空。例如,如果您在升级前手动创建了 Drupal 8 节点,而源站点 Drupal 6/7 也有相同 ID 的节点,迁移系统会覆盖您在 Drupal 8 中手动创建的节点。

如果检测到 ID 冲突,系统会显示警告,如下图所示。您可以忽略警告并冒险丢失数据,或者中断并采用已知问题文档中描述的替代方法。

d7-upgrade-id-conflict

执行升级

升级前分析页面是执行实际升级前的最后一步,因此这是您点击“取消”的最后机会。一旦点击“执行升级”,流程就会开始。

根据源站点的内容和配置规模,升级可能需要很长时间(大数据集可能需要数小时)。由于密码加密的原因,用户账号的导入尤其耗时。系统会在过程进行中持续显示进度和错误反馈:

DrupalUpgradeProgress

新消息会显示在页面顶部,旧消息会随着过程推进而消失到底部。

查看迁移日志

升级过程中显示的所有消息之后都可以查看。在过程完成后,您会进入站点首页,并显示总结信息:

DrupalUpgradeResults

在这里,您可以查看已记录的消息并检查所有错误。该模块使用 Drupal 内置日志系统,因此在默认配置下,您可以直接查看存储在数据库中的日志,链接如下:

DrupalUpgradeLogs

您可以筛选消息列表,仅显示通知(用于正面反馈)或错误(用于迁移过程中发现的问题)。如果出现问题,可能是遇到了 bug(请查看问题队列或联系迁移团队),也可能是数据集过大(请尝试使用 Drush 升级)。