ThinkPHP分页实战：基于地理位置（LBS）的附近商家分页-ThinkPHP-PHP中文网

paginate()直接使用会丢失距离排序，因其count查询不支持order by中的计算字段，需改用原生sql分页或子查询封装距离计算。

thinkphp分页实战：基于地理位置（lbs）的附近商家分页

为什么 `paginate()` 直接套用会丢失距离排序

ThinkPHP 的 paginate() 默认只处理 LIMIT + OFFSET，不感知 ORDER BY 中的计算字段（比如 ROUND(6378.138 * ACOS(SIN(PI() * :lat / 180) * SIN(PI() * lat / 180) + COS(PI() * :lat / 180) * COS(PI() * lat / 180) * COS(PI() * :lng / 180 - PI() * lng / 180)), 2)）。一旦你把距离计算写在 order() 里再调 paginate()，底层生成的 COUNT 查询会报错——因为 COUNT 不允许含函数、别名或子查询。

实操建议：

必须改用 Db::query() 或原生 SQL 手动分页，绕过 ORM 的自动 COUNT
若坚持用 paginate()，得先查出 ID 列表（带距离排序），再用 where IN 查详情——但 ID 列表超 1000 条时 MySQL 会慢，且无法跳转到末页

更稳的做法：用子查询封装距离计算，让主查询只对结果集分页，例如：

SELECT * FROM (SELECT id, name, ROUND(...) AS distance FROM shop WHERE ... ORDER BY distance) t LIMIT 0,10

如何在分页 SQL 中安全传入用户经纬度参数

直接拼接 $lat 和 $lng 到 SQL 字符串里是危险的，尤其当它们来自 GET 请求时。ThinkPHP 的 query() 支持参数绑定，但要注意：绑定参数不能用于字段名或函数名，只能用于值。

实操建议：

用 Db::query() + 占位符，例如：

Db::query("SELECT id, name, ROUND(6378.138 * ACOS(...), 2) AS distance FROM shop WHERE lat BETWEEN ? AND ? AND lng BETWEEN ? AND ? ORDER BY distance LIMIT ?, ?", [$minLat, $maxLat, $minLng, $maxLng, $offset, $limit]);

先用 Haversine 公式粗筛矩形范围（lat BETWEEN + lng BETWEEN），再在内存或 SQL 中精排距离——否则全表算距离性能极差
确保 $lat、$lng 已用 floatval() 过滤，避免字符串注入或类型隐式转换异常

分页响应里怎么同时返回总数量和每条的距离

用户需要知道“共多少家”，又想看到“每家离我多远”，但 paginate() 的 total() 方法依赖 COUNT 查询，而你已放弃自动 COUNT。这时候不能靠前端累加，也不能漏掉总数——否则无法渲染页码栏。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

实操建议：

手动执行一次 COUNT，复用相同的 WHERE 条件（不含 ORDER 和 LIMIT），例如：

$count = Db::query("SELECT COUNT(*) FROM shop WHERE lat BETWEEN ? AND ? AND lng BETWEEN ? AND ?;", [$minLat, $maxLat, $minLng, $maxLng]);

把距离字段（distance）和总数（total）一起塞进响应数组，不要依赖 toArray() 默认结构
如果用 Redis 缓存分页结果，记得把 total 也缓存一份，并设相同过期时间，避免缓存穿透

高并发下 LBS 分页卡顿的三个关键优化点

地理位置分页是最容易拖垮数据库的场景之一：函数计算耗 CPU、无索引导致全表扫描、OFFSET 越大越慢。不是加个 index(lat, lng) 就完事。

实操建议：

给 lat 和 lng 建联合索引，但顺序要按查询条件来；如果常用「某城市范围内」，可加 city_id 到联合索引最左位
用「游标分页」替代 OFFSET：上次查询的最小 distance 值作为下一页起点，SQL 改成 WHERE distance > ? ORDER BY distance LIMIT 10，彻底避开 LIMIT 5000,10 类慢查询
距离值保留小数点后 2 位即可，ROUND(..., 2) 比 ROUND(..., 4) 在排序和比较时快不少，尤其数据量大时