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 侧超时设置问题。
重点看 Redis 日志和配置：
-
timeout配置项：默认 0（永不过期），但如果设成了 300，空闲 5 分钟就会断连；PHP 客户端没做保活，复用长连接时容易中招 -
maxclients达到上限：redis-cli info | grep connected_clients对比maxclients值，满额后新命令直接被拒 - 内存不足触发
maxmemory策略，且maxmemory-policy设为noeviction以外的值，某些写操作会被拒绝并断连 - PHP-FPM 子进程复用 Redis 连接时，若上一个请求异常中断（如 die、exit、超时），连接对象残留但底层 socket 已失效，下次调用直接崩
临时规避：每次操作前加 $redis->ping() === '+PONG' 检查连接有效性，或统一用 try/catch 捕获 RedisException 后重建连接。
Mac M 系列 / Apple Silicon 上编译 Redis 扩展总失败？
不是扩展本身不兼容，是编译链路默认用了 x86_64 工具链，而 PHP 是 arm64 架构。
关键动作：
- 确保
phpize和php-config来自 arm64 版本 PHP（which phpize和file $(which phpize)看架构） -
brew install autoconf automake libtool后，进redis源码目录执行：phpize && ./configure --with-php-config=$(which php-config) && make clean && make - 如果还报
ld: unsupported tapi file type '!tapi-tbd' in YAML file，加环境变量：export ARCHFLAGS="-arch arm64"再重试
装完的 redis.so 必须是 arm64 架构：file modules/redis.so 输出里要有 arm64 字样，否则运行时直接 Segmentation fault。
