17370845950

需先安装并启动 memcached 服务端，再安装 PHP 的 memcached 扩展；服务未运行会导致 connect() 失败，扩展名、函数名、端口、服务状态任一缺失均使 set() 返回 false。

确认系统已安装 memcached 服务端

Memcached 扩展（memcached）只是 PHP 的客户端，不提供缓存服务本身。如果只装扩展但没跑 memcached 服务，new Memcached() 能实例化，但 connect() 会失败，报错类似：Failed to connect to server: Connection refused。

• Linux（Ubuntu/Debian）：运行 sudo apt install memcached，然后 sudo systemctl start memcached
• Linux（CentOS/RHEL）：用 sudo yum install memcached 或 sudo dnf install memcached，再 sudo systemctl start memcached
• macOS：用 brew install memcached，再 memcached -d 启动（默认监听 127.0.0.1:11211）
• Windows：官方不支持原生服务端，建议用 WSL 或 Docker 运行；扩展仅支持客户端功能

PHP 安装 memcached 扩展的两种主流方式

注意区分 memcache（旧、单线程、已废弃）和 memcached（新、支持二进制协议、SASL、多线程）。你要装的是后者。

• 方式一：用包管理器（推荐 Linux/macOS）
  Ubuntu/Debian：sudo apt install php-memcached（自动匹配当前 PHP 版本）
  CentOS/RHEL 8+：sudo dnf install php-pecl-memcached
  macOS + Homebrew PHP：pecl install memcached（需提前装好 libmemcached）
• 方式二：手动编译（兼容性要求高时用）
  先装依赖：sudo apt install libmemcached-dev（Debian/Ubuntu）或 sudo yum install libmemcached-devel（RHEL）
  再执行：pecl install memcached
  成功后检查 php.ini 是否自动加了 extension=memcached.so；没加就手动添加

验证扩展是否生效及常见连接失败原因

装完别急着写代码，先确认扩展加载成功：

php -m | grep memcached

输出 memcached 表示已启用。再运行：

getServerList()); // 应返回空数组
var_dump($m->addServer('127.0.0.1', 11211)); // 应返回 true
echo $m->getVersion()['127.0.0.1:11211'] ?? 'fail';
?>

如果 addServer 返回 false 或 getVersion 报错，常见原因：

• memcached 服务未运行，或监听地址不是 127.0.0.1:11211（查 ps aux | grep memcached 和启动参数）
• SELinux（RHEL/CentOS）阻止 PHP 进程访问网络，临时关掉测试：sudo setenforce 0
• PHP 运行用户（如 www-data）被防火墙限制，而 CLI 下能连——说明是 Web 服务器环境问题，非扩展本身
• 扩展版本与 PHP 版本不兼容（如 PHP 8.2 用了为 PHP 7.4 编译的 .so），用 php -v 和 pecl list 核对

Windows 下 PHP 使用 memcached 的现实路径

Windows 没有官方 memcached 服务端，也没有预编译的 memcached.dll（PECL 已移除 Windows 支持）。可行方案只有两个：

• 用 WSL2 运行 Linux 环境，在其中装 memcached 服务 + PHP memcached 扩展，PHP 代码通过 127.0.0.1:11211 连 WSL 的服务（需配置 WSL 端口转发）
• 改用 Docker：docker run -d -p 11211:11211 --name memcached memcached:alpine，PHP 连宿主机 127.0.0.1:11211
• 绝对不要尝试找第三方编译的 memcached.dll —— 多数不更新、无签名、易崩溃，且不支持 SASL 和二进制协议

扩展名、函数名、端口、服务状态，四个点漏一个，Memcached::set() 就永远返回 false。调试时优先看 $m->getResultCode() 和 $m->getResultMessage()，比猜快得多。