phpEnv下配置Memcached缓存插件实战-php教程-PHP中文网

phpenv 下 memcached 扩展不生效是因为未同时部署服务端、加载匹配的 memcached.dll 扩展、正确配置 php.ini 且重启相关服务；需手动安装 memcached.exe 服务、放入对应 ext 目录、启用 extension=memcached、确认 extension_dir 路径、重启 phpenv 的 web 与 php 服务，并在 wordpress 中正确放置 object-cache.php 文件。

phpenv下配置memcached缓存插件实战

phpEnv 下无法直接启用 Memcached 缓存插件——因为 phpEnv 本身不内置 Memcached 服务端，也不自动加载 memcached.so 扩展，必须手动补全服务、扩展、PHP 配置三要素，缺一不可。

phpEnv 环境里为什么 `memcached` 扩展始终不生效

phpEnv 是 Windows 下的轻量 PHP 开发环境套件，预装的是精简版 PHP（通常不含 memcached 扩展），且默认不启动 Memcached 服务。你执行 php -m | findstr memcached 返回空，或 phpinfo() 里搜不到 memcached support，基本就是以下原因：

没单独安装 Memcached 服务端（memcached.exe）并设为开机自启
没下载匹配 PHP 版本（如 PHP 8.1 TS/NTS）、线程安全模式（TS）和架构（x64/x86）的 memcached.dll 文件
没在 phpEnv 对应的 php.ini（不是系统默认那个）里添加 extension=memcached，也没确认 extension_dir 指向正确目录
重启了浏览器但没重启 phpEnv 的 Apache/Nginx 和 PHP-FPM 进程（仅刷新页面无效）

Windows 下手动部署 Memcached 服务端（非 WSL）

phpEnv 不带 Memcached 服务，必须自己部署一个 Windows 兼容版本。推荐使用官方编译版或更稳定的第三方打包版（如 nono303/memcached-win64）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

解压后得到 memcached.exe，建议放至 C:\memcached\
以管理员身份运行 CMD，执行：memcached.exe -d install 注册为 Windows 服务
再执行：memcached.exe -d start 启动服务（默认监听 127.0.0.1:11211）
验证是否运行：telnet 127.0.0.1 11211，能连上且无拒绝提示即成功

phpEnv 中启用 `memcached` 扩展的实操要点

phpEnv 的 PHP 是独立路径（如 D:\phpEnv\php\php-8.1-x64\），所有配置必须针对该路径操作：

下载对应版本的 memcached.dll（例如 PHP 8.1 TS x64），放入 ext/ 目录（如 D:\phpEnv\php\php-8.1-x64\ext\）
编辑该 PHP 版本下的 php.ini（不是 Windows 目录下的全局 ini），取消注释或新增：extension=memcached
确认 extension_dir 值为："D:\phpEnv\php\php-8.1-x64\ext"（路径末尾不加反斜杠）
重启 phpEnv 控制面板中的「Web 服务」和「PHP 服务」（不是只点“重启 Apache”）
新建 test_mem.php 放入站点根目录，内容为：
```
<?php $m = new Memcached();
$m->addServer('127.0.0.1', 11211);
var_dump($m->getVersion());
?>
```
访问该文件，输出类似 array(1) { ["127.0.0.1:11211"]=> string(6) "1.6.35" } 即表示扩展与服务通信正常

WordPress 在 phpEnv 中启用 Memcached 缓存的关键动作

WordPress 不会自动用上 Memcached，必须靠 object-cache.php 覆盖默认缓存逻辑。注意这不是普通插件，而是 drop-in 文件：

从 tollmanz/wordpress-pecl-memcached-object-cache 下载最新版，解压取出 object-cache.php
把它直接丢进 WordPress 的 wp-content/ 目录（不是 wp-content/plugins/！）
确保 wp-config.php 中有定义：define('WP_CACHE', true);（放在 /* That's all, stop editing! */ 上方）
删除 wp-content/object-cache.php 后再重传一次——Windows 下 FTP 工具常因缓存导致覆盖失败
检查命中率：访问 /wp-admin/tools.php?page=memcached（需安装 Memcached Is Your Friend 插件辅助诊断），get_hits / (get_hits + get_misses) > 85% 才算有效

最易被忽略的一点：phpEnv 默认关闭持久连接，Memcached::OPT_CONNECT_TIMEOUT 和 Memcached::OPT_RETRY_TIMEOUT 若未显式设置，在高并发模拟下可能触发超时静默失败——哪怕 getVersion() 能通，真实业务请求仍会 fallback 到数据库。