数据迁移

一键把 WordPress、Emlog、Typecho、Z-Blog 的文章、分类、标签、评论等导入 Hope CMS。支持修正正文/封面图片地址、防重复导入、分批写入与进度可视，以及内容原文批量替换，适合整站迁移。

功能亮点

• 多源导入：WordPress（WXR）、Emlog（SQL）、Typecho（XML / SQL）、Z-Blog（MT txt / SQL）
• 完整内容：文章、独立页面、分类、标签、评论；Emlog 另支持用户密码还原与友链
• 图片地址修正：推荐先把原站上传目录拷到 content/upload/；可改写旧路径，本地已有文件则直接换链，其余再按源站地址下载并写入资源库
• 内容替换：按原文精确替换文章（内容 / 摘要 / 封面）、媒体库路径、微语中的字符串（不自动加 http）
• 防重复导入：默认跳过已存在文章 / 分类 / 评论 / 链接，再次导入同一备份不易叠数据
• 草稿策略：保持原状态 / 全部发布 / 全部草稿
• 分批导入：大备份按批写入，带进度条、统计与日志；支持取消导入
• 安全增量：只新增数据，不清空本站现有内容；同名用户复用且不改密

支持来源

使用方法

1. 选择来源类型
2. 上传对应备份文件（SQL 类可填写表前缀）
3. （推荐） 将原站上传目录拷到本站 content/upload/（保持年月等子目录）
4. 按需勾选选项（见下表；「导入用户 / 友链」仅 Emlog 显示）
5. 选择草稿策略
6. 点击 开始导入，等待进度走完；需要时可 取消导入（已写入数据不自动回滚）

导入完成后可在页面顶部查看「上次导入」摘要（新建 / 跳过等统计）。

选项说明

内容替换

用于换域名、改路径或清理正文中的固定字符串。入口在插件设置页下方「内容替换」卡片。

1. 查找：填要匹配的原文（原样匹配，不自动加 http://）
2. 替换为：填替换后的字符串；可留空表示删除匹配内容
3. 勾选范围：文章（内容 / 摘要 / 封面）、资源媒体库、微语
4. 可先点 预览影响，再点 开始替换

说明：

• 区分大小写，按输入原文精确替换
• 直接改写数据库，不可自动撤销，执行前请备份

图片目录对照（拷到 content/upload/）

拷贝后请尽量保持年月等子目录结构，再开启「修正正文/封面图片地址」。

各平台准备说明

WordPress

后台 工具 → 导出 → 全部内容，上传生成的 XML。会解析特色图（_thumbnail_id）。

Emlog

下载数据备份 SQL（或 .sql.gz），表前缀默认 emlog_。可将 content/uploadfile 拷到 Hope 的 content/upload 后开启图片修正。用户密码可直接还原。

Typecho

• 推荐：后台导出 XML（WordPress 兼容 WXR）
• 或导出数据库 SQL；前缀默认 typecho_
• 正文中的 <!--markdown--> 标记会自动去除，保留 Markdown 原文
• 可将 usr/uploads 拷到 content/upload

Z-Blog

• 推荐：安装应用中心「MT 数据格式导出」，导出 .txt
• 或使用 Z-BlogPHP 数据库 SQL；前缀默认 zbp_
• 支持封面字段与简介首图回落；可将 zb_users/upload 拷到 content/upload

注意事项

• 导入为增量，不会清空现有文章 / 用户 / 链接
• 同名用户名或邮箱会复用已有账号，且不修改其密码
• 默认开启防重复时，已导入过的内容会跳过；取消勾选「跳过已存在内容」可强制再插入
• 大文件请调高 PHP upload_max_filesize、post_max_size、max_execution_time
• 远程下载图片依赖服务器外网访问，耗时更长
• 仅管理员可执行导入
• 取消导入不会自动回滚已写入数据
• 搬家后请检查固定链接、主题与附件路径是否需手动调整；正文内旧地址可用「内容替换」批量改写
• 「内容替换」会直接改库，执行前请备份数据库

环境要求