Win11 环境下 phpStudy 安装 Redis 最新版，并为 PHP 8.5.9（NTS）配置 redis 扩展

Win11 环境下 phpStudy 安装 Redis 最新版并为 PHP 8.5.9NTS配置 redis 扩展本教程面向 Windows 11 本地开发环境使用 phpStudy Pro目标完成两件事——① 在 Windows 上装好 Redis尽量用较新版本② 给 phpStudy 里手工放置的PHP 8.5.9NTS装上 redis 扩展让 PHP 能通过new Redis()连接 Redis。前置条件已按上一篇教程把 PHP 8.5.9NTS手工放入 phpStudy 并生成php.ini目录为D:\phpstudy_pro\Extensions\php\php8.5.9nts。如果你还没完成这一步请先参考「phpStudy 手工安装最新稳定版 PHP 8.5.9NTS方法」。特别提醒Redis 官方不提供 Windows 版只发布 Linux 版本。Windows 下能装的都是社区/第三方「移植版或兼容版」。另外phpStudy 软件管理里自带的 Redis 版本很旧仅Redis 3.0.504功能落后所以本教程重点讲手动安装较新的 Windows 移植版 Redis。一、认识 Redis 与 Windows 的几种安装方案Redis 官方只支持 LinuxWindows 11 上常见方案如下方案说明版本新旧上手难度phpStudy 软件管理一键安装面板里点一下即装好并托管服务很旧仅 Redis 3.0.504最低Windows 原生移植版手动从 GitHub 下载编译好的 Windows 版 Redis可拿到较新版本中等WSL2 安装官方 Redis真正用上官方最新版 Redis最新较高需处理与 Windows PHP 的网络互通由于 phpStudy 自带的 Redis 只有 3.0.504本教程推荐直接采用方式二手动安装较新版本方式一仅作最省事的备选适合对版本无要求的场景。二、方式一phpStudy 软件管理一键安装 Redis最简单但版本旧⚠️注意phpStudy 软件管理里自带的 Redis 是Redis 3.0.5042016 年的老版本很多新特性如 Stream、新版集群命令等都不支持。对版本有要求的话请跳过本节直接用「方式二」手动安装较新版本。打开 phpStudy Pro 面板进入「软件管理」。在列表中找到Redis通常在「数据库」或「工具」分类下。点击「安装」等待下载安装完成。回到首页在服务列表中启动 Redis默认端口6379。验证是否启动成功。打开 phpStudy 自带的命令行工具或进入 Redis 安装目录执行redis-cli.exe ping返回PONG即表示 Redis 运行正常。这种方式最简单但版本停在3.0.504仅适合对 Redis 版本没有要求、只想本地跑通的场景。装完即可直接跳到「四、下载 PHP redis 扩展」。三、方式二手动安装 Windows 原生移植版 Redis推荐解决内置版本过旧因为 phpStudy 内置 Redis 只有 3.0.504太旧所以推荐走本节手动安装换成较新的 Windows 移植版。3.1 下载 Windows 版 Redis提供 Windows 版 Redis 的常见来源redis-windows/redis-windowsGitHubhttps://github.com/redis-windows/redis-windows/releases提供较新的 Redis 7.x Windows 版追求新版本首选。tporadowski/redisGitHubhttps://github.com/tporadowski/redis/releases提供 Redis 5.0.x 的 Windows 移植版zip / msi老牌稳定大量教程使用。以redis-windows/redis-windows为例追求老牌稳定也可改选tporadowski/redis步骤一致打开 Releases 页面下载最新的.zip例如Redis-7.x-Windows-x64.zip版本号以页面实际最新为准。解压到指定目录例如D:\Redis\解压后目录内应能看到这些文件D:\Redis\ ├── redis-server.exe ├── redis-cli.exe └── redis.windows.conf3.2 启动 Redis并注册为 Windows 服务可选前台启动临时验证用双击redis-server.exe即可。注册为 Windows 服务开机自启、后台常驻用管理员身份打开 CMD 或 PowerShell进入 Redis 目录后依次执行redis-server.exe --service-install redis.windows.conf --service-name redis redis-server.exe --service-start --service-name redis验证redis-cli.exe ping返回PONG即成功。说明redis.windows.conf里bind 127.0.0.1、port 6379默认即可本地开发无需改动。若想设置密码把requirepass前的#去掉并设置密码同时后面 PHP 连接时也要带上密码。四、下载与 PHP 8.5.9NTS匹配的 redis 扩展关键phpStudy 手工放置的官方 PHP 包里默认不带php_redis.dll——redis 是 PECL 扩展不随 PHP 官方安装包分发所以必须单独下载。核心原则下载的扩展 DLL 必须与 PHP 的版本号8.5、架构x64、线程安全性NTS、编译器VS17完全一致否则会加载失败或直接报错。打开 PECL 的 redis 扩展页面https://pecl.php.net/package/redis找到提供Windows DLL的版本选择与PHP 8.5 x64 NTS VS17对应的包下载文件名形如php_redis-6.x.x-8.5-nts-vs17-x64.zip具体版本号以页面实际提供的为准例如 6.2.x 系列起支持 PHP 8.5。务必认准文件名里的8.5、nts、vs17、x64这几个关键字缺一不可。解压后得到php_redis.dll文件。如果 PECL 页面上暂时找不到 PHP 8.5 对应的 Windows DLL说明该版本 Windows 二进制还没发布。可考虑① 换用 phpStudy 内置 PHP 版本其ext目录自带较全的扩展 DLL② 等待官方发布③ 自行编译门槛较高不展开。五、放置扩展文件并修改 php.ini把php_redis.dll复制到 PHP 8.5.9 的扩展目录D:\phpstudy_pro\Extensions\php\php8.5.9nts\ext\打开 php.iniD:\phpstudy_pro\Extensions\php\php8.5.9nts\php.ini确认extension_dir指向ext目录一般默认即是extension_dir ext在扩展配置区添加一行注意确保行首没有分号extensionredis提示php_redis.dll对应的 ini 写法就是extensionredis前缀php_与后缀.dll会自动补全。如需更完整的序列化支持可再配合安装 igbinary但本地开发非必须。保存php.ini。六、重启并验证回到 phpStudy 面板重启该网站对应的服务或直接重启整个环境。确认 Redis 服务处于启动状态。在网站根目录新建redis_test.php内容如下?php// 1. 检查扩展是否加载if(!extension_loaded(redis)){exit(redis 扩展未加载);}// 2. 连接本机 Redis$redisnewRedis();$redis-connect(127.0.0.1,6379);// 3. 写入并读取一个测试值$redis-set(phpstudy:test,hello redis);echo$redis-get(phpstudy:test);// 预期输出hello redis浏览器访问该文件若输出hello redis说明 Redis 服务与 PHP redis 扩展均工作正常。也可以另建phpinfo.php内容为?php phpinfo();在页面里搜索redis能看到 redis 区块含版本号即表示扩展已成功加载。七、常见问题PHP 启动报错「无法定位程序输入点」或 DLL 加载失败扩展版本不匹配。重新确认下载的是8.5 nts vs17 x64的 DLL。TS/NTS 选错是最常见原因——phpStudy 用 NTS别下成 TS。php.ini 加了extensionredis但 phpinfo 里没有 redis依次排查① DLL 是否放进了正确的ext目录② 改的是否是当前 PHP 实际加载的那份php.ini别改错文件③ 改完是否重启了服务。连接127.0.0.1:6379被拒绝Redis 服务没启动或端口被占用。先确认redis-cli.exe ping能返回PONG。phpStudy 内置 Redis 版本旧3.0.504想升级停掉内置 Redis再按「方式二」手动安装新版本并注册服务即可注意两个 Redis 的端口不要冲突。Redis 设了密码后 PHP 连不上连接时带上密码例如$redis-connect(127.0.0.1,6379);$redis-auth(你的密码);总结因为 phpStudy 内置 Redis 只有老旧的 3.0.504整个流程分两段——装 Redis推荐到 GitHub 下较新的 Windows 移植版并注册服务对版本无要求时才用软件管理一键装和装 PHP 扩展到 PECL 下与8.5 NTS x64 VS17严格匹配的php_redis.dll放进ext目录php.ini加extensionredis重启验证。记住两点即可避坑Redis 官方没有 Windows 版PHP 扩展的版本、架构、NTS/TS 必须与 PHP 完全一致。