需先安装并启动 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 表示已启用。再运行：
立即学习“PHP免费学习笔记（深入）”；
<?php
$m = new Memcached();
var_dump($m->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服务 + PHPmemcached扩展，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()，比猜快得多。
