ThinkPHP 项目启用 Redis 需三步：先在宝塔中为网站对应 PHP 版本安装 redis 扩展并重启；再安装并启动 Redis 服务，设置密码与端口；最后在 ThinkPHP 配置文件中正确填写 host、port、password 等参数，并用 Cache::store('redis')->set/get 实测验证。
在 ThinkPHP 项目中启用 Redis，核心前提是 PHP 环境已正确安装并启用了 redis 扩展。宝塔面板下操作更直观，但关键细节容易出错——比如扩展没装到对应 PHP 版本、密码没配对、或配置文件写错位置。
确认当前 PHP 版本和运行环境
先明确网站实际使用的 PHP 版本（不是系统默认版本）。在宝塔面板「网站」→ 找到你的站点 → 点击「设置」→「PHP 版本」，记下版本号（如 7.4 / 8.1）。后续所有操作都必须针对这个版本执行。
- 进该 PHP 版本的「设置」→「安装扩展」→ 勾选 redis 并安装
- 安装完成后，点击「重载配置」或重启 PHP 服务
- 用
phpinfo()验证：新建一个info.php文件，内容为<?php phpinfo(); ?>，访问它，搜索 “redis”，看到模块信息即表示成功
宝塔中安装并配置 Redis 服务
Redis 服务本身需独立运行，不能只装扩展不启服务。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 宝塔「软件商店」→ 搜索 Redis → 安装（推荐 7.x 或 6.x 稳定版）
- 安装后点击「设置」→「配置修改」，建议设置密码（如
myredis123），并确认端口为6379 - 点「服务」→ 启动 Redis，并设为开机自启
- 终端执行
redis-cli -p 6379 -a "myredis123" ping，返回PONG表示服务通
ThinkPHP 中配置 Redis 缓存驱动
以 ThinkPHP 5.1/6.x 为例，配置入口不同，但逻辑一致：指定 type、host、port、password 和 prefix。
立即学习“PHP免费学习笔记（深入）”；
-
TP5.1：修改
config/cache.php的stores['redis']数组，确保'type' => 'redis'，'host' => '127.0.0.1'，'port' => 6379，'password' => 'myredis123' -
TP6.x：在
config/redis.php中配置连接参数；同时在config/cache.php的default或 store 中指定使用redis驱动 - 务必检查
prefix是否含非法字符（推荐纯英文+冒号，如tp5:），避免 key 冲突
验证是否真正生效
别只看配置文件有没有报错，要实测读写。
- 在控制器中写一段测试代码：
Cache::store('redis')->set('test_key', 'hello redis', 3600); - 再执行
echo Cache::store('redis')->get('test_key');，能输出即说明通路完整 - 如果报错“Connection refused”：检查 Redis 服务是否运行、端口是否被防火墙拦截
- 如果报错“AUTH failed”：确认
password字段值与宝塔 Redis 设置完全一致（区分大小写、空格）
