thinkphp配置redis缓存需四步：①启用phpredis扩展并重启服务；②安装topthink/think-redis包；③在config/cache.php中完整配置stores.redis的type/host/port/database四项（type小写、port和database为整型、空密码显式写''）；④关闭prefix并清空runtime/cache后，用php think cache:test验证连接。
ThinkPHP默认用file驱动存缓存，每次读写都走磁盘IO，高并发下接口响应明显变慢；改成Redis后缓存读写变成内存操作，QPS能翻几倍，但改错一个字段就静默退回file驱动，查日志还找不到报错。
确认PHP环境已加载redis扩展
这一步漏掉，后面全白配——ThinkPHP 6/8 依赖原生phpredis扩展，不是predis，也不是只装composer包就能跑。【必须执行 php -m | grep redis 看到输出 redis】。没输出？Linux用户运行 sudo apt-get install php-redis（Ubuntu/Debian）或 sudo yum install php-pecl-redis（CentOS/RHEL）；Windows用户去pecl.php.net下载对应PHP版本的php_redis.dll，放进ext目录，php.ini里加extension=php_redis.dll。改完php.ini后【必须重启PHP-FPM和Web服务器】，否则扩展永远不生效。
安装官方Redis适配器包
TP6/TP8默认不带Redis驱动类，光有扩展也不行。在项目根目录执行：composer require topthink/think-redis。装完检查vendor/topthink/think-redis/src/Driver.php是否存在——不存在说明包没装成功或autoloader失效。如果项目用了Swoole或自定义CLI命令，还得手动调用ThinkRedisServiceProvider::register()，否则服务提供者不会被加载。
改配置：四步填全stores.redis
只改'default' => 'redis'不够，TP会静默fallback到file驱动，毫无提示。必须在config/cache.php的'stores'数组里补全redis配置块，且以下四项缺一不可：
① 'type' => 'redis'——必须全小写，写成'Redis'或'REDIS'直接失效；
② 'host' => '127.0.0.1'——不能留空、不能注释、不能指望“默认值”，Docker环境要填宿主机IP或service名；
③ 'port' => 6379——必须是整型，写成'6379'字符串会导致连接失败但无报错；
④ 'database' => 0——ThinkPHP 8 强制要求显式声明，不写或写成"0"会引发部分命令异常；
密码字段按Redis版本选：【Redis ≥6.0且启用ACL时用 'auth' => 'your-pass'，传统模式用 'password' => 'your-pass'，空密码也必须写 ''】。
关前缀+清缓存，立刻验证是否真连上
ThinkPHP默认给所有key加think:前缀，你用redis-cli get user_123肯定查不到——实际存的是think:user_123。调试阶段直接在stores.redis里加'prefix' => ''关掉前缀。配置改完别急着测业务，先清空runtime/cache/目录——旧缓存配置可能被自动加载缓存住，不清它永远走file驱动。最后用命令行验证：php think cache:clear → php think cache:test，看到Redis connection OK才算真正生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
