php 8 安装 redis 扩展并连接需两步:先精准安装兼容版本的 redis 扩展(linux 用 pecl install redis-5.3.8,windows 下载匹配 ts/nts 的 php_redis.dll),再用 new redis() 实例化并 connect() 连接服务端,配合 ping、auth、setex 等方法完成操作。

PHP 8 安装 Redis 扩展并连接,核心是两步:正确安装 ext-redis 扩展模块,再用 PHP 代码建立到 Redis 服务器的有效连接。关键不在“能不能装”,而在“装对版本、配对路径、连对服务”。
确认环境与前提条件
动手前先理清三个独立但必须共存的组件:
-
Redis 服务器:必须已安装并正在运行(如
redis-server进程存在),可通过redis-cli ping返回PONG验证; -
PHP 8 运行环境:明确你实际使用的 PHP 版本(如
php -v输出PHP 8.2.9),以及 SAPI 类型(CLI / FPM / Apache 模块); -
扩展兼容性:PHP 8.2 推荐使用
redis-5.3.8或redis-6.0.2,避免用旧版(如 5.3.6)或未声明支持 8.2 的版本。
Linux 下安装 Redis 扩展(推荐 PECL 指定版本)
不依赖默认 pecl install redis,而是精准控制版本和路径:
- 确认 PHP 主版本和
php-config路径:php -v和php-config --version必须一致为 8.2.x; - 执行指定版本安装:
sudo pecl install redis-5.3.8(注意写全版本号); - 查看扩展存放位置:
php-config --extension-dir,记下路径(如/usr/lib/php/20220829); - 编辑对应 php.ini:
php --ini查出配置文件路径,在其中添加:extension=redis.so; - 重启对应服务(如
sudo systemctl restart php8.2-fpm或 Apache); - 验证加载:
php -m | grep redis应输出redis,不是php -i | grep redis(后者可能缓存旧信息)。
Windows 下安装(以 phpstudy 或手动部署为例)
PECL 在 Windows 不可用,必须手动下载匹配 DLL:
- 访问 PHP for Windows PECL 页面,选择与你环境完全匹配的包:
— PHP 版本(如 8.2.9)
— 线程安全(TS 对应 Apache 模块,NTS 对应 CLI/FPM)
— 架构(x64)
— 编译器(vs16 对应 VS2019+); - 解压后取
php_redis.dll,放入 PHP 的ext目录(如D:/phpstudy_pro/Extensions/php/php8.2.9nts/ext); - 在 php.ini 中确保:
extension_dir = "D:/phpstudy_pro/Extensions/php/php8.2.9nts/ext"extension=php_redis.dll; - 重启 Web 服务(如 Nginx 或 Apache),用
php -m检查 redis 是否在列表中。
PHP 代码连接 Redis 并简单操作
扩展启用后,连接和使用非常直接:
- 实例化客户端:
$redis = new Redis();; - 建立连接(含超时和密码):
$redis->connect('127.0.0.1', 6379, 2.5);if ($redis->auth('your_password') === false) { throw new Exception('Auth failed'); }; - 写入缓存(带过期):
$redis->setex('user:1001:name', 3600, 'zhangsan');; - 读取缓存:
$name = $redis->get('user:1001:name');; - 调试建议:连接后立即执行
$redis->ping(),返回+PONG表示链路通;若失败,检查 Redis 是否运行、端口是否被防火墙拦截、密码是否正确。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











