PHP Redis扩展不显示需先验证是否真正安装成功:运行php -m | grep redis和php –ri redis均正常才说明加载成功;否则检查php.ini路径一致性、extension路径正确性及PHP版本匹配性。
PHP Redis 扩展装完但 phpinfo() 不显示?先确认是否真装上了
很多问题其实卡在“以为装了,其实没生效”。php -m | grep redis 和 php --ri redis 必须都返回正常信息才算装成功;如果报 Extension 'redis' not found,说明扩展没加载进 PHP 运行时,和 Redis 服务连不连得上无关。
常见漏点:
-
extension=redis.so(Linux/macOS)或extension=php_redis.dll(Windows)没加到正确的php.ini—— 注意是 CLI 用的 ini 还是 Web 用的 ini,php --ini和phpinfo()里 “Loaded Configuration File” 路径必须一致 - 扩展文件路径写错,比如
extension=/usr/lib/php/20220829/redis.so中的20220829是 PHP 版本对应的 API ID,换 PHP 小版本就可能变,不能硬抄 - 扩展编译时没匹配当前 PHP 版本,比如用 PHP 8.2 编译的
redis.so强行塞进 PHP 8.1 运行,会静默失败
Redis 服务明明跑着,new Redis() 连却报 Connection refused
这说明 PHP 扩展已加载,但网络层不通。不是扩展问题,是连接配置或服务状态问题。
检查顺序:
立即学习“PHP免费学习笔记(深入)”;
- 用
redis-cli -h 127.0.0.1 -p 6379 ping直接测通不通;如果也报Connection refused,说明 Redis 没监听或根本没启 - 确认 Redis 配置:
bind是否写了127.0.0.1(而非127.0.0.1 ::1或空),protected-mode yes时必须设密码或关保护模式,port是否被改过(默认 6379) - PHP 代码里别写
new Redis()->connect('localhost', 6379)——localhost在部分系统会走 socket 而非 TCP,改用127.0.0.1更稳 - Docker 或 WSL 环境下,
127.0.0.1指的是容器/子系统自身,不是宿主机;PHP 在容器里连宿主 Redis,得用宿主机网关 IP(如172.17.0.1)或配置host.docker.internal
Redis::connect() 成功但 set() 报 Redis server went away
连接建立后很快断开,大概率是服务端主动踢了,不是 PHP 侧超时设置问题。