源码系统概览
文章正文
wp-cache-db 是一款面向 WordPress 的开源数据库查询缓存插件源码。
它通过替换 WordPress 底层的 wpdb 数据库类，在查询真正执行之前拦截 SELECT 请求，并直接返回已经缓存的结果集。
在开启缓存之后，大量重复的前台读查询可以做到零 SQL 实际命中，从而显著降低数据库的压力与响应耗时。
插件提供了本地文件缓存、本地 Memcached、百度云与新浪云等多种缓存后端，站长可以按服务器环境灵活选择。
对于以内容展示为主、读请求远多于写请求的中文站点来说，这是一套轻量且易于研究改造的数据库优化方案。
源码简介
wp-cache-db 由开发者 midoks 早期发布，当前版本为 2.0，定位是轻量的 WordPress 数据库查询缓存解决方案。
插件核心由一个名为 db.php 的 WordPress drop-in 文件驱动，它会在 wp-content 目录下被加载并实例化 DbCache 类接管查询。
DbCache 类继承自 WordPress 原生的 wpdb，并在自身的 query 方法中实现了缓存命中判断与结果回写逻辑。
当一条 SELECT 查询进来时，插件先对整条 SQL 语句做 md5 哈希作为缓存键，命中则直接返回上一次的结果集。
未命中时插件执行真实查询，把结果写入选定的缓存后端，并在开启触发更新时按数据表分组登记缓存键。
插件内置的 php-sql-parser 第三方解析库用于解析 SQL 语句，从而提取被查询的数据表名称，支撑按表失效能力。
整体代码规模不大、逻辑集中，适合需要为读多写少站点做数据库负载优化的站长进行学习或二次开发。
后台通过一个简洁的设置页面即可完成启用、缓存方式、超时时间与触发更新的开关配置。
适用场景
适合以内容展示为主、读请求远多于写请求的 WordPress 博客、企业官网与资讯类站点。
适合服务器数据库负载偏高、MySQL 连接数经常吃紧，希望减少重复查询开销的运维场景。
适合已经部署或计划部署 Memcached 内存缓存环境，可以最大化本插件的缓存命中效率。
适合作为学习 WordPress 数据库抽象层与缓存中间件接入方式的源码教学样例。
不适合高并发实时写、强一致性要求极高的交易类或社区互动类站点直接使用。
功能亮点
零 SQL 查询命中：前台 SELECT 命中缓存后不再访问数据库，直接返回结果集，降低 DB 负载。
多后端支持：内置本地文件缓存、本地 Memcached、百度云 Memcache 与新浪云 Memcache 多种存储。
按表分组失效：开启触发更新后，后台更新某张表的数据会自动清除该表相关的缓存键。
易扩展接口：缓存后端以独立类实现，开发者可在 api 目录下仿照新增自己的缓存驱动。
轻量无侵入：仅替换数据库类，不修改主题与业务代码，后台提供启用、方式、超时与触发更新开关。
附带调试入口：支持通过 URL 参数调试查询缓存行为，方便排查命中与失效情况。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：WordPress 后台设置页面（原生 PHP 输出） 后端：PHP（WordPress 插件，DbCache |
依具体方案选型，需自行搭建与维护 |
| 部署方式 | 将插件目录上传到 wp-content/plugins/wp-cache-db，并在后台启用名为“DB缓存”的插件。 | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 零 SQL 查询命中：前台 SELECT 命中缓存后不再访问数据库，直接返回结果集，降低 DB 负载。 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：WordPress 后台设置页面（原生 PHP 输出）
后端：PHP（WordPress 插件，DbCache 继承 wpdb）
数据库：MySQL / MariaDB（被缓存的查询源）
运行环境：PHP 5.x 及以上版本的 WordPress 环境，需 wp-content 写权限
其他依赖：可选 Memcached 扩展；内置 php-sql-parser 第三方解析库
安装与部署提示
将插件目录上传到 wp-content/plugins/wp-cache-db，并在后台启用名为“DB缓存”的插件。
启用时插件会自动把 db.php 复制到 wp-content 根目录，作为数据库类 drop-in 接管后续查询。
进入“设置 – DB缓存”页面，选择缓存方式（local 本地文件最为稳妥）、设置超时时间与触发更新。
配置文件默认写入服务器 /tmp 目录下的 options.conf，请确保该路径在你的环境可写且安全。
停用插件时会自动删除 wp-content/db.php 并清理配置，避免遗留 drop-in 影响后续数据库查询。
若使用本地文件缓存，请确认插件 cache 目录具备读写权限，否则缓存无法落盘生效。
建议先在测试环境验证前台读查询命中与后台写更新失效是否符合预期，再考虑上生产。
截图与演示说明
下图为 wp-cache-db 在 aosen.cc 的源码预览与后台设置界面示意，可直观看到插件结构与配置入口。
后台“DB缓存设置”页面提供启用开关、缓存方式下拉、超时时间输入框与触发更新复选框。
缓存方式下拉包含 local、memcached 本地版、memcached 百度云版与 Memcache 新浪云版四个选项。
页面底部还提供“保存设置”“清空数据”“清空过期数据”三个操作按钮，便于即时维护缓存。
源码根目录包含 wp-cache-db.php、db.php、cache.class.php、common.php、object-cache.php 与 api 缓存后端目录。
其中 object-cache.php 是一套独立的 Memcached 对象缓存实现，可作为 WordPress 对象缓存 drop-in 使用。
从代码结构看，wp-cache-db-main 下分为 api、cache、common、object-cache 与 php-sql-parser 等模块，职责清晰。
常见问题
问：启用插件后前台文章列表为什么有时不更新？
回答：这通常是缓存尚未过期或触发更新未开启导致。可在后台打开“触发更新”，或在设置页点击“清空数据”强制刷新。
问：本地文件缓存方式需要注意什么？
回答：local 方式会把缓存写入插件 cache 目录，请确保该目录对 PHP 进程可写，并留意磁盘空间与读写权限。
问：插件提示数据库类被替换是否有风险？
回答：db.php 是 WordPress 标准的数据库 drop-in 机制，本插件借此接管查询。停用插件会自动移除该文件，一般无需担心。
安全风险提示
特别提示：本项目在缓存后端代码中检出凭据类与逻辑类风险，部署前请务必进行安全审计。
路径：wp-cache-db-main/api/BaeMcCache.php
类型：硬编码云凭据
证据：该文件内写死了百度云 Memcache 的 cacheid、user 与 pwd 等连接凭据，并非占位示例。
建议：请勿直接使用 baeMc（百度云）缓存方式，或先把其中的凭据替换为你自己的云服务账号信息。
路径：wp-cache-db-main/cache.class.php
类型：前台写查询拦截
证据：query 方法对非后台页面的写类型 SQL（insert、update、delete 等）直接 return 1 而不执行真实查询。
建议：这会导致前台留言、注册、表单提交等功能失效，生产环境务必充分测试或针对性改造后再上线。
另外 common.php 将配置写入服务器 /tmp 目录，共享主机环境下存在被其他用户读取的可能，建议改为私密路径或数据库存储。
特别提示：以上风险请在部署前处理，源码仅供学习研究，请务必审计删除可疑代码后再上线使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本插件为开发者早期开源作品，使用与分发请遵循其原始许可与作者声明。
下载后请先按上文安全提示审计硬编码凭据与配置路径问题，再决定是否用于生产环境。
如在本地测试，建议优先使用 local 本地文件缓存方式，避免依赖已停服的第三方云平台。
若需用于正式站点，请充分评估写查询拦截逻辑对前端表单与互动功能的影响。
请通过本站提供的下载入口获取源码压缩包，部署前做好备份与隔离测试。
