必须选对PHP版本并安装memcached（带d）扩展，而非memcache；object-cache.php须放wp-content根目录且权限为644；wp-config.php中define('WP_CACHE', true)须在require_once之前；验证需CLI测试、phpinfo确认及Hit Rate观察。
宝塔里装Memcached扩展，必须选对PHP版本和扩展名
宝塔面板中安装Memcached扩展，不是在“软件商店”搜 memcached 装服务端，而是进对应PHP版本的「设置 → 安装扩展」里勾选 memcached（注意结尾带 d）。装错成 memcache（没 d）会导致 object-cache.php 加载失败，WordPress后台报 Class 'Memcached' not found。
常见错误现象：
- PHPinfo 页面搜
memcached没结果，或只显示memcache - 宝塔PHP扩展列表里，“memcached”按钮仍是“安装”，不是“卸载”
- 重启PHP后仍不生效 —— 必须确认你操作的是当前WordPress实际使用的PHP版本（比如网站绑定的是PHP 8.2，就得去PHP 8.2的扩展页装）
上传 object-cache.php 到 wp-content，不是 plugins 目录
WordPress对象缓存机制只认 /wp-content/object-cache.php 这个路径。无论你用哪个来源的文件，都必须直接放进去，不能放在 /wp-content/plugins/ 下，否则完全不触发缓存逻辑。
可用来源（任选其一）：
- GitHub 原版：
https://github.com/tollmanz/wordpress-pecl-memcached-object-cache下载后解压取object-cache.php - WPJAM-Basic 插件附带：启用该插件后，从
/wp-content/plugins/wpjam-basic/template/object-cache.php复制过去 - Memcached Is Your Friend 插件：启用后它会在自己插件目录生成
object-cache.php，再手动复制到/wp-content/
关键点：复制完立刻检查文件权限是否为 644，且属主与Web服务器一致（如 www-data 或 www），否则PHP读取失败，日志里会报 failed to open stream: Permission denied。
wp-config.php 中只需加 define('WP_CACHE', true)
不需要额外加 define('ENABLE_CACHE', true) 或其他自定义开关。WordPress原生对象缓存机制只依赖 WP_CACHE 这个常量，且必须在 wp-config.php 中、require_once(ABSPATH . 'wp-settings.php'); 之前定义。
生产级WordPress REST API集成，用于管理文章、页面、媒体、WooCommerce产品、Elementor内容、SEO元数据、ACF及JetEngine字段
正确写法示例：
define('WP_CACHE', true);
/** WordPress 设置文件... */
require_once(ABSPATH . 'wp-settings.php');容易踩的坑：
- 把
define('WP_CACHE', true)写在wp-settings.php之后 —— 完全无效 - 误加了
define('MEMCACHED_SERVERS', ...)等自定义配置 —— 当前主流object-cache.php版本默认连127.0.0.1:11211，除非你改过Memcached监听地址，否则无需干预 - 同时启用了多个缓存插件（如Redis + Memcached）—— 可能互相覆盖，优先级取决于哪个
object-cache.php文件先被加载（仅一个有效）
验证是否真生效，别只看后台插件状态
插件页面显示“已启用”不等于Memcached在工作。真实生效要看两点：一是PHP能连上Memcached服务，二是有缓存命中。
快速验证方法：
- 在网站根目录新建
mem-test.php，内容为：
<?php
$m = new Memcached();
$m->addServer('127.0.0.1', 11211);
$m->set('test_key', 'ok', 30);
echo $m->get('test_key') ?: 'fail';
?>访问该文件输出 ok，说明PHP扩展和服务通信正常；
- 登录宝塔 → PHP管理 → 查看PHPinfo → 搜索
memcached，确认memcached support是enabled，且libmemcached version不为空； - 打开宝塔「Memcached」服务页，观察「Hit Rate」是否随访问上升（稳定在70%以上才算有效）；若长期为0%，大概率是
object-cache.php没放对位置，或WP_CACHE未生效。
最易被忽略的一点：宝塔安装的Memcached服务默认只监听 127.0.0.1，如果你的WordPress跑在Docker或非本地PHP-FPM环境下，得手动改 /www/server/memcached/etc/memcached.conf 的 -l 参数，否则连接超时。
