使用 XenForo Importers 从 XenForo 2.2 导入到 XenForo 2.3 的详细教程​

前提条件​

1. 新站点已安装 XenForo 2.3：你的新站点需要先安装并配置好 XenForo 2.3。
2. 旧站点是 XenForo 2.2：旧站点使用的是 XenForo 2.2，并希望将数据迁移到 XenForo 2.3。
3. 备份数据：在开始操作前，请备份 XenForo 2.2 的数据库和文件，防止操作失误导致数据丢失。

步骤 1：准备旧站点的数据​

1. 备份 XenForo 2.2 数据库：
   • 登录到 phpMyAdmin 或使用 命令行工具 导出旧站点的数据库。
   • 导出为 SQL 格式，确保导出整个数据库。
     注：你可以在 phpMyAdmin 的 “导出” 页面选择 自定义导出，然后选择 SQL 格式。
2. 备份文件夹：
   • 下载 XenForo 2.2站点的所有文件，特别是以下两个文件夹：
     • data 文件夹：包含所有附件、上传的文件。
     • internal_data 文件夹：包含缓存、媒体文件等重要数据。
   这两个文件夹将用于数据迁移时的附件和媒体文件。

步骤 2：安装并配置 XenForo Importers 插件​

1. 下载并安装 XenForo Importers 插件：
   • XenForo 官方会提供 XenForo Importers 插件，通常该插件与 XenForo 2.3 一起提供。如果你没有该插件，可以从OKSGO本站下载！
2. 安装插件：
   • 登录到 XenForo 2.3 后台管理面板，进入 系统 -> 导入和导出 页面。
   • 在该页面，你会看到 导入器 选项，点击进入。
   • 在选择数据源时，选择 XenForo 2.x（适用于从 XenForo 2.2 版本迁移数据）。

步骤 3：配置导入器并连接到旧数据库​

1. 配置旧站点数据库连接： 在导入界面中，XenForo 2.3 会提示你配置连接到 XenForo 2.2的数据库。你需要提供以下信息：
   • 数据库主机：通常为 localhost 或数据库服务器的 IP 地址。
   • 数据库名：你为 XenForo 2.2 设置的数据库名。
   • 数据库用户名：访问数据库的用户名。
   • 数据库密码：用于连接数据库的密码。
   这些信息可以在你旧站点的 config.php 文件中找到：
   
   代码: 复制到剪贴板

   $config['db']['host'] = 'localhost'; // 数据库主机
   $config['db']['dbname'] = 'old_xenforo_db'; // 旧站点数据库名
   $config['db']['username'] = 'root'; // 数据库用户名
   $config['db']['password'] = ''; // 数据库密码

2. 配置数据路径：
   • 导入器需要知道你从旧站点备份的文件夹位置，即 data 和 internal_data 文件夹路径。
   • 数据文件夹：选择你的旧站点的 data 文件夹路径，包含所有附件和上传的文件。
   • 内部数据文件夹：选择旧站点的 internal_data 文件夹路径，包含缓存和媒体文件。

步骤 4：选择导入选项并开始导入​

1. 选择导入选项： 导入器会提供一些选项来配置导入行为：
   • 覆盖现有数据：如果你希望清除新站点的数据并替换为旧站点的数据，选择此项。
   • 保留用户密码：默认情况下，系统会保留用户密码，这样用户登录时无需重新设置密码。
   • 保留权限设置：如果你希望保留旧站点的权限设置，选择此项。
   你可以根据需要选择这些选项。
2. 启动导入： 配置完成后，点击 开始导入，导入过程会自动启动。
   

   导入可能会花费一定的时间，具体时间取决于数据量和服务器性能。

   点击展开...

步骤 5：导入过程监控和日志​

1. 监控导入进度：
   • 在导入过程中，XenForo 会显示进度日志，记录当前导入的数据内容。
   • 如果有任何错误或警告，它们会显示在日志中，帮助你排查问题。
2. 错误处理：
   • 如果出现错误，XenForo 会根据错误类型给出详细的提示，帮助你定位并解决问题。常见的问题包括数据库连接错误、数据格式问题等。

步骤 6：导入完成后的检查和验证​

1. 验证导入的数据：
   • 登录到 XenForo 2.3 后台，确认以下数据是否都已成功导入：
     • 用户数据：确认所有用户及其相关数据（如帖子、权限等）是否导入成功。
     • 帖子内容：查看一些帖子，确认它们的内容、附件是否正确。
     • 版块结构：检查版块、子版块是否和旧站点一致。
     • 附件：确保所有附件和上传文件已正确导入。
2. 重新构建搜索索引：
   • 导入完成后，访问 系统 -> 搜索索引，点击 重新构建搜索索引，确保所有帖子和内容能正确被索引。
3. 清除缓存：
   • 在 系统 -> 缓存管理 中，选择 清除缓存 或 重新生成缓存，确保新站点能正常运行。

步骤 7：优化和清理​

1. 删除临时文件：
   • 在导入过程中，可能会生成一些临时文件。完成导入后，删除这些不必要的文件以节省空间。
2. 数据库优化：
   • 在 系统 -> 数据库优化 中执行优化操作，清理不必要的数据，优化数据库性能。

常见问题及解决方法​

1. 导入失败或超时：
   • 如果导入过程超时或失败，可以尝试以下几种方法：
     • 增加 PHP max_execution_time 和 memory_limit 参数，确保 PHP 能够处理大数据量。
     • 可以通过分批次导入数据，避免一次性导入过多数据导致超时。
   • 在 php.ini 中修改如下：
   代码: 复制到剪贴板

   max_execution_time = 300
   memory_limit = 512M

2. 字符编码问题：
   • 如果导入后出现乱码，请检查数据库字符集是否设置为 UTF-8。可以在 phpMyAdmin 或命令行中确认并修改数据库字符集。
   • 在命令行中，可以使用以下命令修改字符集：
   sql
   
   代码: 复制到剪贴板

   ALTER DATABASE old_xenforo_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. 附件丢失：
   • 如果附件丢失，检查 data 和 internal_data 文件夹的上传路径是否正确，并确认文件夹权限设置为可读写。
   • 通过文件管理器或 FTP 客户端检查是否有权限问题。

总结​