XAMPP环境安装Redis扩展 XAMPP连接Redis数据库-php教程-PHP中文网

php架构与redis.dll必须严格匹配：xampp默认为ts/x64，需下载对应ts版本dll；php.ini中仅写extension=redis；redis服务需单独安装并监听6379端口；连接时用127.0.0.1而非localhost。

xampp环境安装redis扩展 xampp连接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-tools

按类别查找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();
}
?>

关键点：