PHP架构与redis.dll必须严格匹配：XAMPP默认为TS/x64，需下载对应TS版本DLL；php.ini中仅写extension=redis；Redis服务需单独安装并监听6379端口；连接时用127.0.0.1而非localhost。
确认 PHP 架构与 redis.dll 是否严格匹配
XAMPP 自带的 PHP 默认是 TS（Thread Safe）版本，且多数为 x64 架构；但 PECL 官网下载的 php_redis.dll 默认是 NTS，直接放进去会导致 Apache 启动失败或报 PHP Startup: Unable to load dynamic library 'redis'。
必须先验证当前 PHP 实际配置：
- 打开命令行，执行
php -v看版本（如8.2.12） - 执行
php -i | findstr "Thread Safe"（Windows），确认输出为enabled→ 必须选TS版本 DLL - 再查
Architecture和Compiler（如VC17,x64）→ 决定下载哪个 ZIP 包
推荐下载地址：https://windows.php.net/downloads/pecl/releases/redis/，找形如 redis-5.3.7-8.2-ts-vs17-x64.zip 的包，解压后只取 php_redis.dll 放入 C:\xampp\php\ext\。
正确配置 php.ini 加载 redis 扩展
在 C:\xampp\php\php.ini 中添加扩展时，不能写全名或带路径，否则 Apache 会报 Invalid configuration directive 或静默失效。
只需加这一行（位置建议放在其他 extension= 行附近）：
extension=redis
注意以下常见错误：
- ❌
extension=php_redis.dll→ PHP 8+ 不支持带后缀写法 - ❌
extension=C:\xampp\php\ext\php_redis.dll→ 绝对路径禁止使用 - ❌ 把
extension=redis写在[XDebug]段落里 → 必须在全局扩展区
改完保存，重启 Apache。用 php -m | findstr redis 验证是否加载成功；若无输出，说明没生效。
Redis 服务必须单独安装并监听 6379 端口
XAMPP 自身不带 Redis 服务，php_redis.dll 只是客户端驱动，不提供服务端。连接失败报 Redis server went away 或 Connection refused，90% 是因为 Redis 进程根本没跑起来。
推荐方案（仅开发环境）：
- 从
https://github.com/microsoftarchive/redis/releases下 Windows 兼容版（如Redis-x64-3.2.100.zip） - 解压到
C:\xampp\redis（路径不含空格和中文） - 以管理员身份运行 CMD，执行：
redis-server --service-install redis.windows.conf --loglevel verboseredis-server --service-start - 检查是否监听：
netstat -ano | findstr :6379，有 PID 输出即正常
如果提示 'redis-server' 不是内部或外部命令，把 C:\xampp\redis 加进系统 PATH 环境变量。
测试连接时注意 host、port 和防火墙
本地测试脚本最常出错的地方不是代码，而是连接参数或网络策略：
新建 C:\xampp\htdocs\test-redis.php：
<?php
$redis = new Redis();
try {
$redis->connect('127.0.0.1', 6379, 2); // 第三个参数是超时（秒），别省略
echo "Connected to Redis<br>";
$redis->set('test', 'OK');
echo $redis->get('test');
} catch (Exception $e) {
echo "Error: " . $e->getMessage();
}
?>
关键点：
- ✅ 用
127.0.0.1，不用localhost（Windows 下可能走 IPv6 或 hosts 解析异常） - ✅ 显式传超时时间，避免卡死
- ✅ 检查 Windows 防火墙是否阻止了 6379 端口（尤其公司网络）
- ❌ 不要尝试连远程 Redis（如
192.168.x.x）除非你明确配了bind和protected-mode no
真正容易被忽略的是：Redis 服务启动后，redis-cli ping 返回 PONG 只代表服务活，不代表 PHP 能连——PHP 连接失败永远优先排查 php_redis.dll 加载状态和端口占用。
