WordPress限制文章和页面历史版本数量并自动清理多余修订记录完整操作手册
如果不想了解整个逻辑,可以直接看到后面的第三步开始看吧,来点直接快速的办法,时间都很宝贵,大家拿着去用。
需求背景和最终目标
WordPress 默认支持文章和页面历史版本控制。
每次编辑并保存文章或页面时,WordPress 都可能生成新的历史修订记录。通过历史版本功能,可以查看以前的内容,并在需要时恢复到旧版本。
但是,如果网站长期运营,文章和页面经过频繁修改,就可能产生大量历史版本。
例如:
- 某个页面已经积累了100多个历史版本。
- 网站有几百篇文章,每篇文章都存在几十条历史记录。
- WordPress 数据库中的
wp_posts表不断增长。 - 不需要保留那么多历史版本,但又不希望完全关闭版本控制。
对于这种情况,完全关闭 WordPress 版本控制并不是最合适的解决方案。
更合理的方式是每篇文章和页面只保留最近5个历史版本,超过5个的旧版本自动删除。
1.1 本文要解决的问题
本文的目标是实现以下效果:
| 管理项目 | 最终要求 |
|---|---|
| 历史版本数量 | 每篇内容最多保留5条普通历史版本 |
| 现有历史记录 | 一次性清理多余记录 |
| 新增历史记录 | 后续更新时自动清理旧版本 |
| 文章类型 | 文章、页面及支持版本控制的自定义文章类型 |
| 自动保存 | 不主动清理自动保存记录 |
| 数据库清理 | 删除历史版本及其关联元数据 |
| 维护方式 | 不需要定期手动清理 |
需要特别注意:
WordPress 的 WP_POST_REVISIONS 配置主要控制版本修订的保留数量,但不会主动清理数据库中已经积累的全部旧版本。
因此,完整解决方案需要分成两个阶段:
- 清理已经存在的历史版本。
- 设置未来自动限制历史版本数量。
二、WordPress历史版本的存储原理
在开始操作之前,先了解历史版本存储在哪里。
WordPress 的文章、页面以及历史修订记录主要存储在数据库的 wp_posts 表中。
它们通过 post_type 字段进行区分。
常见类型如下:
| post_type | 说明 |
|---|---|
| post | 普通文章 |
| page | 普通页面 |
| revision | 历史版本 |
| attachment | 媒体附件 |
| 自定义名称 | 自定义文章类型 |
例如,一篇页面可能存在以下记录:
| ID | post_parent | post_type | 说明 |
|---|---|---|---|
| 100 | 0 | page | 原始页面 |
| 101 | 100 | revision | 第1个历史版本 |
| 102 | 100 | revision | 第2个历史版本 |
| 103 | 100 | revision | 第3个历史版本 |
| 104 | 100 | revision | 第4个历史版本 |
| 105 | 100 | revision | 第5个历史版本 |
| 106 | 100 | revision | 第6个历史版本 |
| 107 | 100 | revision | 第7个历史版本 |
其中:
ID是当前记录的数据库编号。post_parent表示这个历史版本属于哪篇原始文章或页面。post_type = revision表示这是一条历史版本记录。
如果一个页面存在100条历史版本,那么就需要删除其中较旧的95条,只保留最新5条。
这里需要区分两个概念:
历史版本 Revision
正常编辑和保存内容时产生的历史记录。
自动保存 Autosave
WordPress 编辑器为了防止内容丢失而产生的自动保存记录。
本文只限制普通历史版本为5条,不主动删除自动保存记录。
三、操作前准备工作
在执行数据库清理之前,建议先完成以下准备工作。
3.1 备份数据库(建议备份一下)
笔者测试没有备份,没有啥问题,如果已经有备份的就备份一下数据以防不测。
可以使用以下任意方式备份:
- 宝塔面板数据库备份。
- phpMyAdmin 导出数据库。
- MySQL 命令行备份。
- WordPress 数据库备份插件。
如果使用 MySQL 命令行,可以执行:
1 | mysqldump -u root -p wordpress > wordpress_backup.sql |
其中 wordpress 替换成实际数据库名称。
3.2 确认数据库表前缀
WordPress 默认表前缀是:
1 | wp_ |
但是有些网站可能使用:
1 | wp123_ |
可以在网站根目录打开 wp-config.php,找到:
1 | $table_prefix = 'wp_'; |
后续 SQL 查询和数据库操作都需要使用实际表前缀。
3.3 确认数据库中的历史版本数量
可以在 phpMyAdmin 的 SQL 执行界面运行:
1 | SELECT COUNT(*) AS revision_count |
如果返回:
1 | revision_count = 1500 |
说明数据库中当前存在1500条历史版本记录。
还可以查看每篇内容分别有多少历史版本:
1 | SELECT |
这样可以快速找到历史版本数量最多的页面或文章。
四、配置WordPress未来历史版本数量
首先修改 WordPress 根目录下的 wp-config.php。
找到:
1 | /* That's all, stop editing! Happy publishing. */ |
在这段代码之前添加:
1 | define( 'WP_POST_REVISIONS', 5 ); |
例如:
1 | define( 'WP_POST_REVISIONS', 5 ); |
这个配置表示 WordPress 默认每篇文章最多保留5个历史版本。
需要注意:
这个配置不会立即清理数据库中已经存在的旧版本。
此外,某些插件和自定义文章类型可能通过 WordPress 过滤器修改版本数量,因此还需要进行后续配置。
五、使用MU插件实现全站统一版本限制
为了避免主题切换后配置失效,推荐使用 WordPress MU 插件。
MU 插件也叫必须使用插件,不需要在后台手动启用,WordPress 会自动加载。
5.1 创建MU插件目录
进入网站目录:
1 | wp-content/ |
如果不存在 mu-plugins 目录,就手动创建:
1 | wp-content/mu-plugins/ |
5.2 创建版本限制插件
在 mu-plugins 目录中创建:
1 | limit-revisions.php |
写入以下代码:
1 | <?php |
这段代码通过 WordPress 官方提供的 wp_revisions_to_keep 过滤器统一限制历史版本数量。
对于支持版本控制的文章类型,返回5。
对于不支持版本控制的文章类型,不主动开启版本控制。
5.3 为什么推荐MU插件
与直接修改主题 functions.php 相比,MU插件具有以下优势:
- 不依赖当前使用的主题。
- 主题升级不会覆盖配置。
- 不需要在 WordPress 后台手动启用。
- 网站启动时自动加载。
- 方便集中维护网站的全局配置。
注意:如果其他插件也修改版本数量,仍需排查过滤器冲突。建议后续通过实际编辑测试验证。
六、一次性清理已有历史版本
完成未来限制配置之后,就可以清理数据库中已经存在的多余历史版本。
这里提供两种方法:
- 使用 WP-CLI 命令行清理。
- 使用 PHP 文件通过浏览器访问清理。
两种方式都调用 WordPress 原生删除接口,不建议直接通过简单的 DELETE SQL 删除历史版本。
原因是 WordPress 的历史版本可能关联 wp_postmeta 等数据,使用原生 API 可以同时处理相关清理逻辑。
6.1 方法一 使用WP-CLI清理
WP-CLI 是 WordPress 官方命令行管理工具,可以直接在服务器终端执行 WordPress 管理操作。
适合具有 SSH 权限的 Linux 服务器。
第一步 安装WP-CLI
官方地址:
安装完成后,进入 WordPress 网站根目录。
执行:
1 | wp --info |
如果可以正常显示 WP-CLI 版本信息,说明安装成功。
第二步 创建清理脚本
在 WordPress 根目录创建:
1 | cleanup-revisions.php |
写入:
1 |
|
第三步 执行清理
进入 WordPress 根目录,执行:
1 | wp eval-file cleanup-revisions.php |
如果网站使用了非默认数据库连接或特殊配置,WP-CLI 应使用对应的网站配置环境。
执行成功后,会看到类似结果:
1 | Success: Cleanup completed. Deleted: 1200, Kept: 300 |
表示本次删除了1200条多余历史版本,保留了300条普通历史版本。
第四步 删除临时文件
清理完成后删除:
1 | cleanup-revisions.php |
避免保留不需要的临时脚本。
6.2 方法二 使用浏览器访问PHP文件清理
如果服务器没有安装 WP-CLI,或者使用 Windows 本地环境,也可以通过 PHP 文件直接执行清理。
这种方法不需要额外安装命令行工具。
适合:
- Windows 本地开发环境。
- PHPStudy 环境。
- 只有 FTP 权限的虚拟主机。
- 无法使用 WP-CLI 的网站环境。
第一步 创建清理文件
进入 WordPress 根目录,也就是 wp-config.php 所在目录。
创建:
1 | cleanup-revisions.php |
写入以下完整代码:
1 |
|
第二步 登录WordPress后台
在浏览器中登录 WordPress 管理员账号。
必须保持管理员登录状态,否则脚本无法通过权限检查。
第三步 访问清理地址
在浏览器打开:
1 | https://你的域名/cleanup-revisions.php |
例如:
1 | https://example.com/cleanup-revisions.php |
正常情况下会看到:
1 | 清理完成! |
这表示清理操作已经执行完成。
第四步 删除临时文件(重要)
执行完成后,立即删除网站根目录中的:
1 | cleanup-revisions.php |
不要长期保留可以直接访问的数据库清理脚本。
6.3 两种清理方法如何选择
| 对比项目 | WP-CLI | 浏览器PHP脚本 |
|---|---|---|
| 是否需要安装工具 | 需要 | 不需要 |
| 是否需要SSH | 需要 | 不需要 |
| 是否需要管理员登录 | 不需要浏览器登录 | 需要 |
| 是否调用WordPress API | 是 | 是 |
| 是否适合Linux服务器 | 推荐 | 可以 |
| 是否适合Windows环境 | 需要配置 | 推荐 |
| 操作难度 | 中等 | 简单 |
两种方式选择一种执行即可,不需要重复执行。
七、验证历史版本是否清理成功
清理完成后,建议通过数据库检查结果。
7.1 检查是否还存在超过5条的历史版本
在 phpMyAdmin 中执行:
1 | SELECT |
如果没有返回任何记录,说明目前所有存在普通历史版本的内容都不超过5条。
7.2 检查历史版本总数量
1 | SELECT COUNT(*) AS revision_count |
可以用来观察清理前后的数据库记录数量变化。
7.3 检查具体页面
可以进入 WordPress 后台:
文章或页面编辑界面 → 历史版本 → 查看历史版本数量。
正常情况下,每篇内容最多显示5条普通历史版本。
八、后续自动清理机制说明
完成上述配置后,网站就具备了长期限制历史版本的能力。
例如,某个页面最初存在5条历史版本:
| 更新时间 | 历史版本数量 | 处理结果 |
|---|---|---|
| 第一次更新 | 1 | 保留 |
| 第二次更新 | 2 | 保留 |
| 第三次更新 | 3 | 保留 |
| 第四次更新 | 4 | 保留 |
| 第五次更新 | 5 | 保留 |
| 第六次更新 | 6 | 删除最旧版本 |
| 第七次更新 | 6 | 再删除最旧版本 |
最终始终保留最新5条普通历史版本。
这里不需要额外配置定时任务,也不需要每天执行数据库清理。
WordPress 会在产生新的历史修订记录时,根据版本数量限制处理超出的旧版本。
需要注意,自动保存记录是独立机制,不应将其与普通历史版本混为一谈。
九、常见问题
9.1 为什么设置WP_POST_REVISIONS之后,历史版本还是很多
因为 WP_POST_REVISIONS 主要控制后续版本保留数量,不会立即清理数据库中已经存在的旧版本。
需要先执行一次历史版本清理脚本。
另外,还需要检查插件是否覆盖了版本数量过滤器。
9.2 为什么使用浏览器访问PHP文件提示Permission denied
通常有以下原因:
- 浏览器没有登录 WordPress。
- 当前登录用户不是管理员。
- 浏览器访问的域名与登录后台的域名不一致。
- 网站存在额外的安全插件或访问限制。
确保先登录正确的 WordPress 管理员账号,再访问清理文件。
9.3 为什么WP-CLI提示wp不是内部或外部命令
说明当前系统无法识别 wp 命令。
常见原因:
- 没有安装 WP-CLI。
- WP-CLI 没有加入系统环境变量。
- 当前终端没有进入正确的服务器环境。
Windows 本地环境可以选择浏览器 PHP 脚本方案,不必为了清理历史版本专门安装 WP-CLI。
9.4 可以直接使用SQL删除历史版本吗
可以,但不建议直接删除。
例如:
1 | DELETE FROM wp_posts |
这种操作会直接删除全部历史版本,无法保留每篇内容最新的5条,也不会通过 WordPress 的删除接口处理关联元数据。
如果确实需要数据库级清理,应使用经过验证的分组排序 SQL,并同时处理孤立的元数据。
对于日常 WordPress 运维,推荐使用 wp_delete_post_revision()。
9.5 历史版本删除后能否恢复
不能通过 WordPress 的历史版本功能恢复已经删除的版本。
因此执行前必须备份数据库。
如果后续需要恢复被删除的内容,只能通过数据库备份进行恢复。
9.6 自动保存记录是否也限制为5条
本文的5条限制针对普通历史版本。
自动保存记录由 WordPress 编辑器单独管理,不计入这5条普通历史版本。
如果希望限制自动保存,还需要单独调整自动保存机制,不能简单地把所有 revision 记录统一删除。
十、最终实施检查清单
按照以下顺序操作即可完成整个需求。
- 备份 WordPress 数据库。
- 检查数据库表前缀。
- 在
wp-config.php设置WP_POST_REVISIONS为5。 - 创建
wp-content/mu-plugins/limit-revisions.php。 - 选择 WP-CLI 或浏览器 PHP 脚本清理历史版本。
- 执行一次性清理。
- 删除临时清理脚本。
- 通过 SQL 检查是否存在超过5条的普通历史版本。
- 更新一篇测试文章,验证后续自动清理是否生效。
- 确认自动保存功能正常。
十一、最终效果
完成全部配置后,WordPress 的历史版本管理将变成以下模式:
| 管理项目 | 最终效果 |
|---|---|
| 已有历史版本 | 一次性清理 |
| 每篇文章 | 最多保留5条普通历史版本 |
| 每个页面 | 最多保留5条普通历史版本 |
| 自定义文章类型 | 对支持版本控制的类型统一限制 |
| 新增历史版本 | 自动清理超出的旧版本 |
| 自动保存 | 独立保留 |
| 数据库关联数据 | 通过WordPress原生删除API处理 |
| 日常维护 | 无需定期手动清理 |
最终建议:
对于长期运营的 WordPress 网站,推荐采用 wp-config.php + MU插件 + 一次性WP-CLI或PHP清理脚本 的组合方式。
其中:
wp-config.php负责声明默认版本数量。- MU 插件负责全站统一版本限制。
- WP-CLI 或 PHP 脚本负责清理已有历史版本。
- WordPress 原生版本管理机制负责后续自动删除超出的旧版本。
这样既不会完全关闭历史版本功能,又能避免历史版本无限积累,兼顾内容恢复能力和数据库维护需求。
参考资料:
- WordPress Revisions:https://wordpress.org/documentation/article/revisions/
- WP_POST_REVISIONS:https://developer.wordpress.org/reference/constants/wp_post_revisions/
- wp_revisions_to_keep:https://developer.wordpress.org/reference/hooks/wp_revisions_to_keep/
- wp_delete_post_revision:https://developer.wordpress.org/reference/functions/wp_delete_post_revision/
- WP-CLI 官方网站:https://wp-cli.org/