thinkphp 8.0 可直接用 redis geo 命令实现“附近的人”,需按经度在前、纬度在后写入 geoadd,再用 georadius 查询,结合 wherein 批量查用户详情并按距离排序。

ThinkPHP 8.0 可以直接利用 Redis 的 GEO 命令实现“附近的人”功能,无需额外安装扩展,关键是把地理位置数据正确写入 Redis 并合理调用原生命令。
准备 Redis GEO 数据结构
Redis GEO 要求经纬度为 经度在前、纬度在后(注意不是常见的“纬度,经度”顺序),且经度范围 -180~180,纬度 -90~90。建议在用户注册/更新位置时,用 geoadd 写入:
- 键名建议按业务区分,例如
lbs:user:location - 每个成员用用户 ID 作为 member,避免中文或特殊字符
- 使用
$redis->geoAdd('lbs:user:location', $lng, $lat, $uid)写入(ThinkPHP 8.0 默认支持 Redis 驱动,可通过think\facade\Cache::store('redis')->handler()获取原生 Redis 实例)
查询指定范围内的用户列表
用 georadius 或 georadiusbymember 获取附近用户。例如:查找以某用户为中心、5 公里内的其他用户:
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
$redis->geoRadius('lbs:user:location', $lng, $lat, 5, 'km', ['WITHDIST', 'WITHCOORD'])- 返回结果包含 member(用户 ID)、distance(距离)、coordinate(经纬度),需自行关联用户信息(如查数据库)
- 若要排除自身,可在 PHP 层过滤掉当前用户的 ID
优化性能与边界处理
真实场景中要注意几个易错点:
- 用户位置未更新时,不要重复写入相同坐标,可加时间戳判断是否超过阈值(如 30 秒)再更新 GEO
- 距离单位支持 m/km/mi/ft,务必统一单位,前端展示时注意换算
- Redis GEO 不支持删除单个 member 的经纬度,如需清理可用
zrem(因 GEO 底层是 Sorted Set) - 高并发下建议对 GEO 操作加锁或使用 pipeline 批量写入,避免频繁连接开销
结合 ThinkPHP 查询用户详情
拿到 Redis 返回的用户 ID 列表后,推荐用 whereIn 一次查出完整用户信息:
UserModel::where('id', 'in', $uids)->field('id,nickname,avatar,lng,lat')->select()- 不建议循环查库,尤其当半径大、人数多时会显著拖慢响应
- 若需排序(如按距离升序),可在 PHP 中对 Redis 返回结果按
distance排序,再合并用户数据
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










