宝塔面板如何为WordPress配置Memcached_安装扩展与插件提升性能-php教程-PHP中文网

必须选对php版本并安装memcached（带d）扩展，而非memcache；object-cache.php须放wp-content根目录且权限为644；wp-config.php中define('wp_cache', true)须在require_once之前；验证需cli测试、phpinfo确认及hit rate观察。

宝塔面板如何为wordpress配置memcached_安装扩展与插件提升性能

宝塔里装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 API Pro

生产级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 参数，否则连接超时。