ThinkPHPRedis怎么连_ThinkPHPRedis连接配置详解【教程】-ThinkPHP-PHP中文网

redis连不上主因是配置、扩展或连接复用问题，需检查phpredis扩展是否正确加载、服务是否运行、docker网络配置、tp缓存配置完整性、哨兵模式设置及连接后ping检测。

thinkphpredis怎么连_thinkphpredis连接配置详解【教程】

Redis 连不上，八成不是密码写错了，而是配置没对上、扩展没装对、或者连接复用逻辑被忽略。ThinkPHP 默认不启用 Redis，也不自带驱动，得手动配齐三件套：扩展、包、配置。

phpredis 扩展装了没？别信 phpinfo 里有 redis 就算数

运行 php -m | grep redis，必须看到 redis（不是 igbinary 或 predis）。Windows 下检查 php.ini 是否启用了 extension=php_redis.dll；Linux/macOS 看是否加载了 redis.so。重启 PHP-FPM 或 Apache 后再测，光改配置不重启等于没改。

new \Redis() 能实例化，但调 connect() 报 Connection refused → 服务没起来或端口/防火墙挡了
报 Class 'Redis' not found → 扩展根本没加载，不是 TP 配置问题
用的是 Docker？确认 redis.conf 里 bind 包含容器网段，别只留 127.0.0.1

config/cache.php 里 redis store 必须显式定义，不能只改 default

TP6/8 不会自动补全 redis 配置项，'default' => 'redis' 只是开关，真正起作用的是 'stores.redis' 下的完整数组。漏掉 host、port、select 中任意一个，都会静默 fallback 到 file 驱动——现象是“缓存没生效但也不报错”。

阿里云-虚拟数字人

阿里云-虚拟数字人是一款面向内容创作、虚拟直播和实时交互的企业级数字人平台。

下载

database 写成字符串 "0" 会导致连接成功但读写失败，必须是整型 0
password 字段在 Redis 6+ ACL 模式下要换成 'auth' => 'xxx'，且用户需有 +@all 权限
用 timeout 控制连接等待时长，设为 0 表示无限等待，线上建议设 2.5 左右防卡死

长连接 persistent=true 是把双刃剑，开之前先看运行模式

'persistent' => true 只对 phpredis 扩展生效，Predis 不支持。开了之后每次请求复用 TCP 连接，但副作用明显：

PHP-FPM 模式下，pm.max_requests 非零时进程重启不会主动 close 持久连接，Redis 端积累大量 ESTABLISHED 状态连接
Swoole/Hyperf 等常驻进程框架里开 persistent，极易引发连接泄漏，此时应换连接池（如 topthink/think-redis 的 pool 配置）
开了 persistent 必须配 prefix，否则多请求共用一个持久化 ID，key 互相污染

哨兵模式不是填个地址就行，host 得设为 null 才触发哨兵逻辑

直接写 'host' => '10.0.1.10:26379' 会连上哨兵节点，但后续 SET 命令失败——因为哨兵返回的是重定向响应，不是 Redis 协议数据。正确姿势是：

host 设为 null 或空字符串，强制 TP 进入哨兵路径
sentinels 必须是数组，每个元素带 host 和 port（如 ['host' => '10.0.1.10', 'port' => 26379]）
service 填哨兵中注册的 master 名（如 myMaster），不是 IP 或 Redis 实例名
phpredis 版本低于 5.3.0 会静默降级为主机直连，务必用 php --ri redis 确认版本