Tutorial/教程 XenForo Importers 导入工具的详细使用教程
使用 XenForo Importers 从 XenForo 2.2 导入到 XenForo 2.3 的详细教程
前提条件
- 新站点已安装 XenForo 2.3：你的新站点需要先安装并配置好 XenForo 2.3。
- 旧站点是 XenForo 2.2：旧站点使用的是 XenForo 2.2，并希望将数据迁移到 XenForo 2.3。
- 备份数据：在开始操作前，请备份 XenForo 2.2 的数据库和文件，防止操作失误导致数据丢失。
步骤 1：准备旧站点的数据
- 备份 XenForo 2.2 数据库：
- 登录到 phpMyAdmin 或使用 命令行工具 导出旧站点的数据库。
- 导出为 SQL 格式，确保导出整个数据库。
注：你可以在 phpMyAdmin 的 “导出” 页面选择 自定义导出，然后选择 SQL 格式。
- 备份文件夹：
- 下载 XenForo 2.2站点的所有文件，特别是以下两个文件夹：
data文件夹：包含所有附件、上传的文件。internal_data文件夹：包含缓存、媒体文件等重要数据。
- 下载 XenForo 2.2站点的所有文件，特别是以下两个文件夹：
步骤 2：安装并配置 XenForo Importers 插件
- 下载并安装 XenForo Importers 插件：
XenForo 官方会提供 XenForo Importers 插件，通常该插件与 XenForo 2.3 一起提供。如果你没有该插件，可以从OKSGO本站下载！
- 安装插件：
- 登录到 XenForo 2.3 后台管理面板，进入 系统 -> 导入和导出 页面。
- 在该页面，你会看到 导入器 选项，点击进入。
- 在选择数据源时，选择 XenForo 2.x（适用于从 XenForo 2.2 版本迁移数据）。
步骤 3：配置导入器并连接到旧数据库
- 配置旧站点数据库连接： 在导入界面中，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'] = ''; // 数据库密码 - 数据库主机：通常为
- 配置数据路径：
- 导入器需要知道你从旧站点备份的文件夹位置，即
data和internal_data文件夹路径。 - 数据文件夹：选择你的旧站点的
data文件夹路径，包含所有附件和上传的文件。 - 内部数据文件夹：选择旧站点的
internal_data文件夹路径，包含缓存和媒体文件。
- 导入器需要知道你从旧站点备份的文件夹位置，即
（可以自己建立一个临时的目录，数据恢复结束后可以删除此目录。）
步骤 4：选择导入选项并开始导入
- 选择导入选项： 导入器会提供一些选项来配置导入行为：
- 覆盖现有数据：如果你希望清除新站点的数据并替换为旧站点的数据，选择此项。
- 保留用户密码：默认情况下，系统会保留用户密码，这样用户登录时无需重新设置密码。
- 保留权限设置：如果你希望保留旧站点的权限设置，选择此项。
- 启动导入： 配置完成后，点击 开始导入，导入过程会自动启动。
导入可能会花费一定的时间，具体时间取决于数据量和服务器性能。
步骤 5：导入过程监控和日志
- 监控导入进度：
- 在导入过程中，XenForo 会显示进度日志，记录当前导入的数据内容。
- 如果有任何错误或警告，它们会显示在日志中，帮助你排查问题。
- 错误处理：
- 如果出现错误，XenForo 会根据错误类型给出详细的提示，帮助你定位并解决问题。常见的问题包括数据库连接错误、数据格式问题等。
步骤 6：导入完成后的检查和验证
- 验证导入的数据：
- 登录到 XenForo 2.3 后台，确认以下数据是否都已成功导入：
- 用户数据：确认所有用户及其相关数据（如帖子、权限等）是否导入成功。
- 帖子内容：查看一些帖子，确认它们的内容、附件是否正确。
- 版块结构：检查版块、子版块是否和旧站点一致。
- 附件：确保所有附件和上传文件已正确导入。
- 登录到 XenForo 2.3 后台，确认以下数据是否都已成功导入：
- 重新构建搜索索引：
- 导入完成后，访问 系统 -> 搜索索引，点击 重新构建搜索索引，确保所有帖子和内容能正确被索引。
- 清除缓存：
- 在 系统 -> 缓存管理 中，选择 清除缓存 或 重新生成缓存，确保新站点能正常运行。
步骤 7：优化和清理
- 删除临时文件：
- 在导入过程中，可能会生成一些临时文件。完成导入后，删除这些不必要的文件以节省空间。
- 数据库优化：
- 在 系统 -> 数据库优化 中执行优化操作，清理不必要的数据，优化数据库性能。
常见问题及解决方法
- 导入失败或超时：
- 如果导入过程超时或失败，可以尝试以下几种方法：
- 增加 PHP
max_execution_time和memory_limit参数，确保 PHP 能够处理大数据量。 - 可以通过分批次导入数据，避免一次性导入过多数据导致超时。
- 增加 PHP
- 在
php.ini中修改如下：
代码:max_execution_time = 300 memory_limit = 512M - 如果导入过程超时或失败，可以尝试以下几种方法：
- 字符编码问题：
- 如果导入后出现乱码，请检查数据库字符集是否设置为 UTF-8。可以在 phpMyAdmin 或命令行中确认并修改数据库字符集。
- 在命令行中，可以使用以下命令修改字符集：
代码:ALTER DATABASE old_xenforo_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; - 附件丢失：
- 如果附件丢失，检查
data和internal_data文件夹的上传路径是否正确，并确认文件夹权限设置为可读写。 - 通过文件管理器或 FTP 客户端检查是否有权限问题。
- 如果附件丢失，检查
![[OzzModz] PB-Change Download File name 更改下载文件名](/data/resource_icons/0/214.jpg?1725525743){kind=icon}