使用网页浏览器升级
在您开始之前
在开始升级之前,请确保您已阅读本指南的前几页:
请确保您正在使用最新版本的 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 站点。
- 参见下方截图。

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

作为站点构建者,您需要仔细查看不会升级的模块。对于每个模块,请评估在 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 中的两个模块。这只是信息展示,无法更改。

ID 冲突警告
如升级准备部分所述,从 Drupal 6/7 升级到 Drupal 8 时,目标站点必须完全为空。例如,如果您在升级前手动创建了 Drupal 8 节点,而源站点 Drupal 6/7 也有相同 ID 的节点,迁移系统会覆盖您在 Drupal 8 中手动创建的节点。
如果检测到 ID 冲突,系统会显示警告,如下图所示。您可以忽略警告并冒险丢失数据,或者中断并采用已知问题文档中描述的替代方法。

执行升级
升级前分析页面是执行实际升级前的最后一步,因此这是您点击“取消”的最后机会。一旦点击“执行升级”,流程就会开始。
根据源站点的内容和配置规模,升级可能需要很长时间(大数据集可能需要数小时)。由于密码加密的原因,用户账号的导入尤其耗时。系统会在过程进行中持续显示进度和错误反馈:

新消息会显示在页面顶部,旧消息会随着过程推进而消失到底部。
查看迁移日志
升级过程中显示的所有消息之后都可以查看。在过程完成后,您会进入站点首页,并显示总结信息:

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

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