在thinkphp 8.0中应使用redis sorted set构建实时热榜,需正确配置redis连接与prefix,通过zadd写入热度分数,用zrevrange分页获取top n数据,更新用zadd覆盖,删除单条用zrem,清空用del。

在 ThinkPHP 8.0 中为文章、商品或视频等资源构建实时热榜,需按热度值动态排序并支持分页查询,直接依赖数据库 ORDER BY 会随数据量增长而变慢,必须用 Redis 的 Sorted Set 结构替代。
配置 Redis 连接并启用 Sorted Set 支持
打开 config/cache.php,确认默认缓存驱动已设为 redis,并检查 redis 配置项中 host、port、password、database 均填写正确。若使用哨兵或集群模式,需额外配置 sentinel 或 cluster 选项,否则 【Sorted Set 操作将静默失败】。
在 config/redis.php 中确保 'prefix' 字段不为空(如 'tp8:'),避免多个项目共用同一 Redis 实例时 key 冲突。
定义热榜数据写入逻辑
在业务模型或服务类中调用 Redis 客户端的 zAdd 方法写入分数:
方法一:单条写入(适用于用户行为触发场景)
使用 $this->redis->zAdd('hot:article', $score, $articleId),其中 $score 为整型热度值(如阅读数×10 + 点赞数×50 + 评论数×100),$articleId 必须是字符串类型;若传入整数 ID,Redis 会自动转为字符串但易引发去重异常。
方法二:批量写入(适用于后台定时更新)
构造二维数组 $data = [['score' => 1280, 'member' => '1001'], ['score' => 942, 'member' => '1002']],调用 $this->redis->zAdd('hot:article', ...array_merge(...$data));注意 PHP 8.1+ 不支持 splat 操作符展开关联数组,必须用 array_column($data, 'score', 'member') 转为 key-value 格式再传入。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
获取热榜前 N 名及分页数据
第一步:获取 Top 10(降序,分数最高在前)
$top10 = $this->redis->zRevRange('hot:article', 0, 9, ['withscores' => true]);返回格式为 ['1001' => '1280', '1002' => '942'],注意 score 是字符串类型,需 (int) 强转后再参与计算。
第二步:分页获取第 2 页(每页 20 条)
起始位置 = (页码 − 1) × 每页条数,即 $start = 20;结束位置 = 起始位置 + 每页条数 − 1 = 39;执行 $this->redis->zRevRange('hot:article', $start, $end, ['withscores' => true])。
第三步:带条件过滤(如仅查有效文章)
先用 zRevRange 获取 ID 列表,再通过 Db::whereIn('id', $ids)->select() 查库补全字段;不能在 Redis 层做 where 过滤,Sorted Set 本身不支持条件筛选。
更新与删除热榜条目
更新某文章热度:直接再次 zAdd 同一 member,Redis 自动覆盖旧分数。这一步操作起来很简单,无需先 zRem 再 zAdd。
下架某文章(从热榜移除):【必须用 zRem 而非 del 删除整个 key】,否则会清空全部榜单数据。调用 $this->redis->zRem('hot:article', $articleId) 即可。
清空整个热榜(慎用):$this->redis->del('hot:article');该操作不可逆,且会阻塞 Redis 其他请求直到删除完成。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










