不能只用cache::store('redis')->handler()，因其每次调用新建连接句柄、无统一前缀、无类型提示与参数校验、无重试/重连机制，高并发下易致连接耗尽或key冲突。
ThinkPHP 本身通过 think\Cache 提供了 Redis 缓存驱动，但它的 set/get 只覆盖 string 类型，且不直接暴露 hGet、lPush、zAdd、unlink 等原生命令。想简化业务调用，必须绕过 Cache 封装一层真正能操作全量 Redis 命令的工具类。
为什么不能只用 Cache::store('redis')->handler()
这个方法确实能拿到底层 Redis 实例，但它有硬伤：
- 每次调用都 new 一个连接句柄（除非你手动复用），在高并发下易触发连接数耗尽或超时
- 没有统一前缀管理，容易和其他系统或模块的 key 冲突
- 返回的实例是原始
Redis对象，不带类型提示、无参数校验、无异常兜底，写错参数（比如把ttl当成秒传毫秒）很难排查 - 无法自动处理连接失败重试、断线重连等生产级需求
封装一个单例 RedisService 类
核心是复用连接、加前缀、统一错误处理。下面是最简可用版本（放在 app/common/service/RedisService.php）：
<?php namespace app\common\service;
use think\Cache;
use think\Exception;
class RedisService
{
private static $instance = null;
private $redis;
private $prefix = 'tp_';
private function __construct()
{
$this->redis = Cache::store('redis')->handler();
if (!$this->redis) {
throw new Exception('Redis handler init failed');
}
// 可选：设置默认前缀（避免和其它项目混用）
$this->prefix = config('cache.stores.redis.prefix', 'tp_');
}
private function __clone() {}
public static function getInstance()
{
if (self::$instance === null) {
self::$instance = new self();
}
return self::$instance;
}
public function set($key, $value, $ttl = 0)
{
$realKey = $this->prefix . $key;
return $this->redis->set($realKey, $value, $ttl);
}
public function get($key)
{
$realKey = $this->prefix . $key;
return $this->redis->get($realKey);
}
public function hGet($key, $field)
{
$realKey = $this->prefix . $key;
return $this->redis->hGet($realKey, $field);
}
public function lPush($key, ...$values)
{
$realKey = $this->prefix . $key;
return $this->redis->lPush($realKey, ...$values);
}
public function unlink($key)
{
$realKey = is_array($key) ? array_map(fn($k) => $this->prefix . $k, $key) : $this->prefix . $key;
return $this->redis->unlink($realKey);
}
}
注意点：
-
config('cache.stores.redis.prefix')要在config/cache.php中配好，否则前缀为空 -
unlink方法兼容单 key 和数组，比原生更安全；TP5 默认没封装它，但它是替代del的推荐方式（异步删除，不阻塞） - 如果用了 Redis 集群或哨兵，
handler()返回的可能是Predis\Client，此时要判断类型再调用对应方法，不能硬写$this->redis->set
在控制器里怎么用才不踩坑
别在每次请求里 new 类，也别用静态调用省事——要用依赖注入或单例模式确保连接复用：
// 正确：复用单例
$redis = \app\common\service\RedisService::getInstance();
$redis->set('user:1001', ['name' => 'Tom'], 3600);
// 错误：每次都 new，连接池失控
new \app\common\service\RedisService(); // ❌
// 错误：用 Cache::store 每次取 handler，连接未复用
$redis = \think\Cache::store('redis')->handler(); // ❌（仅适合简单读写、低频场景）
常见陷阱：
- 传入
null或空字符串做 key，会导致 Redis 报错ERR invalid argument，建议在set/get方法开头加if (empty($key)) { return false; } - 对
hMSet这类批量方法，TP5.1+ 的Redis扩展要求第二个参数是关联数组，传索引数组会静默失败 - 使用
zAdd时，分值（score）必须是数字，字符串如'100'会被当成 0，导致排序错乱
最常被忽略的是前缀一致性：缓存配置里的 prefix、工具类里的 $prefix、以及手写 $redis->get('xxx') 时的 key，三者必须统一。漏掉一个，查不到数据还怀疑是 Redis 挂了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
