PHP连Redis需先安装并启用redis扩展,再用Redis类显式设置超时和密码,每次请求新建连接,避免FPM复用陷阱。

PHP 连 Redis 不是“进数据库”,而是通过客户端扩展连接内存数据服务;没装 redis 扩展或配置错 host/port,new Redis() 会直接报错或超时。
确认 PHP 是否已启用 redis 扩展
Redis 不是 PHP 内置模块,必须手动安装并启用扩展。常见错误是只装了 redis-server,却没装 PHP 的 redis 扩展(不是 phpredis 包名,扩展名就是 redis)。
- 运行
php -m | grep redis,有输出才说明扩展已加载 - 没输出?Linux 下通常执行
sudo apt install php-redis(Ubuntu/Debian)或sudo yum install php-pecl-redis(CentOS/RHEL) - Windows 用户需检查
php.ini中是否取消注释了extension=redis,且对应php_redis.dll在ext/目录下 -
phpinfo()页面里搜 “redis” 能看到版本号和 loaded configuration file 才算真正生效
用 Redis 类建立基础连接
PHP 官方推荐使用 Redis 类(非 Predis 第三方库),构造简单但默认不带重连和超时兜底,线上务必显式设置。
- 最简连接:
$redis = new Redis(); $redis->connect('127.0.0.1', 6379); - 生产环境必须加超时:
$redis->connect('127.0.0.1', 6379, 2.5);—— 第三个参数是连接超时(秒),避免阻塞 - 若 Redis 配了密码,紧接着调用
$redis->auth('your_password');,注意:auth 必须在 connect 之后、任何命令之前 - 连接失败时
connect()返回false,但不会抛异常,得自己判断:if (!$redis->connect(...)) { throw new Exception('Redis connection failed'); }
连接池或长连接?PHP-FPM 场景下别乱复用实例
PHP 是无状态的请求生命周期模型,new Redis() 实例不能跨请求复用(比如放 global 或 static 变量里)。有人试图用 pconnect,但实际效果有限且易引发端口耗尽。
立即学习“PHP免费学习笔记(深入)”;
-
$redis->pconnect()在 CLI 模式下有效,但在 PHP-FPM 中因进程回收机制,常导致连接残留或认证失效 - 更稳妥做法:每次请求按需新建连接,靠 Redis 服务端的连接复用能力(如 keepalive)维持底层 TCP 效率
- 如果真要减少 connect 开销,可封装一个工厂函数,内部用
static $instances缓存,但 key 必须包含 host+port+auth,且要加 try/catch 检查连接有效性(例如执行ping()) - 高并发下注意
maxclients配置,默认 10000,单机 PHP-FPM worker 数 × 平均每请求连接数不能超这个值
Redis 连接看似就几行代码,但超时设置、密码时机、扩展缺失、FPM 复用陷阱——四个点里踩中一个,就会表现为“连不上”“偶尔失败”“本地行线上不行”。真正卡住人的从来不是语法,而是这些没报错却静默失效的环节。











