Windows 下安装 Redis 扩展的完整指南

Redis 是一个高性能的键值数据库，在 Windows 环境下为 PHP 安装 Redis 扩展，可以显著提升网站的数据处理能力，尤其适用于缓存、会话存储等场景。很多开发者在安装过程中会遇到各种问题，本文将为你提供从零开始、清晰易懂的解决方案。

一、安装前的准备工作：确认你的“装备”

在开始安装前，你需要先明确几个关键信息，这就像修车之前要知道车型和发动机型号一样。

第一步：确认你的 PHP 版本

在网站根目录（比如 www 或 htdocs 文件夹里）新建一个文件，命名为 phpinfo.php。
用记事本打开这个文件，输入一行代码：<?php phpinfo(); ?>，然后保存。
打开浏览器，访问 http://localhost/phpinfo.php（如果你的本地网站地址不同，请相应修改）。
在打开的页面中，找到 “PHP Version” 这一行，记下完整的版本号，比如 7.4.3。

第二步：确认“线程安全”类型和系统架构 在同一个 phpinfo.php 页面里，继续寻找两个关键信息：

Thread Safety：找到这一项，看后面是 enabled 还是 disabled。这决定了你需要下载 TS（线程安全）还是 NTS（非线程安全）版本的扩展。
Architecture：找到 “System” 或 “Architecture” 这一项，看后面是 x86 还是 x64。这决定了你需要32位还是64位的扩展文件。

第三步：确认你的 PHP 扩展目录 同样在 phpinfo.php 页面，搜索 “extension_dir”，找到这一项后面的路径，比如 C:\php\ext。这个目录就是你一会儿要放扩展文件的地方，请记下来。

完成以上三步，你就得到了安装 Redis 扩展的“寻宝图”：PHP 版本号、TS/NTS 类型、x86/x64 架构、扩展目录路径。

二、核心步骤：获取并安装扩展文件

第一步：下载正确的 Redis 扩展 DLL 文件

打开浏览器，访问一个可靠的 PHP 扩展资源网站。
在网站上找到与你的 PHP 版本、架构（x86/x64）、线程安全（TS/NTS）完全匹配的 Redis 扩展。文件名通常类似 php_redis-5.3.7-7.4-ts-vc15-x64.zip。
- 5.3.7 是 Redis 扩展版本
- 7.4 对应你的 PHP 版本
- ts 代表线程安全（如果是 nts 则代表非线程安全）
- x64 代表 64 位（如果是 x86 则代表 32 位）
下载这个 ZIP 压缩包到电脑上。

第二步：放置扩展文件并启用

解压刚下载的 ZIP 文件，在里面找到 php_redis.dll 文件。
将这个 php_redis.dll 文件，复制到你之前找到的 PHP 扩展目录（例如 C:\php\ext）里。
找到你的 PHP 配置文件 php.ini。如果你不确定它在哪，可以在 phpinfo.php 页面搜索 “Loaded Configuration File”，就能看到它的完整路径。
用记事本（建议用 Notepad++ 等专业编辑器）打开 php.ini 文件。
在文件中找到 ;extension=... 这样的区域（通常可以用记事本的查找功能搜索 extension=），在任意一个 extension= 设置的后面，新起一行，添加以下代码：
```
extension=redis
```
注意：这里只写 extension=redis，而不是 extension=php_redis.dll。因为 extension_dir 已经指定了目录，系统会自动寻找 php_redis.dll。
保存并关闭 php.ini 文件。

第三步：重启服务并验证安装

重启你的 Web 服务器：
- 如果你使用的是 Apache，在系统服务里重启 Apache 服务，或在命令行（以管理员身份运行）输入 net stop apache2.4 然后 net start apache2.4（服务名可能略有不同）。
- 如果你使用的是 Nginx 且 PHP 以 PHP-FPM 运行，则重启 PHP-FPM 服务。
- 如果你使用的是 集成环境（如 XAMPP, PHPStudy），请通过其控制面板重启 Apache 或 Nginx。
再次打开之前创建的 phpinfo.php 页面，按 Ctrl+F 搜索 “redis”。
如果能看到一个独立的 “redis” 版块，里面显示着 Redis 扩展的版本信息，那么恭喜你，Redis 扩展已经成功安装并启用了！

三、常见问题与故障排除

问题1：打开 phpinfo.php 页面，找不到 redis 版块。

检查：确认 php.ini 中 extension=redis 的拼写无误，且已保存。
检查：确认 php_redis.dll 文件已放入正确的 extension_dir 目录。
检查：确认下载的 DLL 文件的 TS/NTS 和 x86/x64 与你的 PHP 环境完全匹配。这是最常见的问题。
检查：是否重启了 Web 服务器？修改 php.ini 后必须重启才能生效。

问题2：页面报错，提示“无法启动此程序，因为计算机中丢失 VCRUNTIME140.dll”或类似。

解决：这是因为缺少 Microsoft Visual C++ Redistributable 运行库。请根据你的系统架构，从微软官网下载并安装 “Visual C++ Redistributable for Visual Studio 2015-2022” 版本。通常安装 x64 版本即可。

问题3：一切就绪，但 PHP 连接 Redis 服务器时失败。

扩展安装成功只代表 PHP 具备了操作 Redis 的能力。你还需要一个 Redis 服务器。
对于 Windows，微软官方不提供原生支持，但可以通过 Windows Subsystem for Linux (WSL) 安装 Linux 版的 Redis 服务器，或者使用由社区维护的 Windows 移植版（如 microsoftarchive/redis，但已停止维护，仅适用于旧版学习和测试）。
对于生产或深入学习，强烈建议在 Linux 虚拟机、WSL 或直接使用云数据库 Redis 服务。

四、进阶使用与优化建议

连接测试：安装扩展后，可以创建一个简单的测试文件 test_redis.php：

<?php
$redis = new Redis();
try {
    // 假设 Redis 服务器在本地默认端口 6379
    $redis->connect('127.0.0.1', 6379);
    $redis->set('test_key', 'Hello Redis!');
    echo "连接成功，键值已设置。读取值: " . $redis->get('test_key');
} catch (Exception $e) {
    echo "连接失败: " . $e->getMessage();
}
?>

运行此脚本前，请确保 Redis 服务器已启动。

性能考虑：在 Windows 上使用 Redis 主要用于学习和开发。对于正式的生产环境，由于性能、稳定性和官方支持的原因，Redis 服务器应部署在 Linux 系统上。你的 PHP 应用（在 Windows 上）可以通过网络连接远端的 Linux Redis 服务器。
管理工具：可以安装 Redis Desktop Manager 或 Another Redis Desktop Manager 等图形化客户端，更方便地查看和管理 Redis 数据库中的数据。