XAMPP安装Redis扩展教程

本文详细讲解了在XAMPP环境下成功启用Redis扩展的完整实战流程，直击开发者常踩的四大坑：PHP线程安全（TS）与架构（x64/VC版本）必须与redis.dll严格匹配，php.ini中扩展加载仅支持简洁写法`extension=redis`，Redis服务需独立安装并确保6379端口正常监听，以及连接时务必使用`127.0.0.1`而非`localhost`以规避Windows网络解析异常——每一步都附带精准验证命令和典型错误对照，帮你绕过玄学报错，5分钟内让PHP真正连上Redis。

确认 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 verbose
redis-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 加载状态和端口占用。

文中关于XAMPP的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《XAMPP安装Redis扩展教程》文章吧，也可关注golang学习网公众号了解相关技术文章。