php 8.6查询附近门店,可把经纬度写入redis地理索引,再用geosearch按半径、距离和数量筛选。返回的是球面距离近似值,不是道路导航距离或到店时间。下面使用redis 6.2及以上版本,并通过已安装的phpredis扩展发送原始命令。

官方文档:GEOADD
连接独立命名空间
先确认PHP 8.6加载了匹配构建的redis扩展,并准备Redis账号、端口与访问限制。示例只在本地演示库使用demo:php86:stores,不改已有业务键;远程连接还需按环境配置ACL与TLS。
<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379, 2.0);
$redis->setOption(Redis::OPT_READ_TIMEOUT, 2.0);
$key = 'demo:php86:stores';
$stores = [
['shop-a',121.4737,31.2304],
['shop-b',121.4850,31.2400]
];
foreach ($stores as [$id,$longitude,$latitude]) {
if (!is_finite($longitude) || !is_finite($latitude)
|| $longitude < -180 || $longitude > 180
|| $latitude < -85.05112878 || $latitude > 85.05112878) {
throw new InvalidArgumentException('Invalid coordinates');
}
$redis->rawCommand('GEOADD', $key, (string)$longitude, (string)$latitude, $id);
}
$rows = $redis->rawCommand('GEOSEARCH', $key,
'FROMLONLAT','121.4737','31.2304','BYRADIUS','5','km',
'ASC','COUNT','10','WITHDIST','WITHCOORD');
if (!is_array($rows)) throw new RuntimeException('Query failed');
foreach ($rows as $row) {
[$id,$distance,$coordinate] = $row;
echo $id, ' ', $distance, ' km ', json_encode($coordinate), PHP_EOL;
}
官方文档:GEOSEARCH
保持坐标顺序与单位一致
GEOADD和FROMLONLAT都是经度在前、纬度在后。WITHDIST的单位跟随BYRADIUS,本例是千米;WITHCOORD返回经纬度数组。把百度、国测和WGS84等不同坐标系的数据直接混用会产生偏差,采集与查询应先约定同一坐标系。
分清门店元数据和地理索引
地理索引保存成员与位置,不会自动保存营业时间、权限或库存。应用应按返回门店ID再查询相应元数据,并在展示前过滤不可见或暂停营业的门店。位置更新可以对同一成员再次GEOADD;删除门店时同步移除索引成员。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
不要把数量限制误读为全局最近结果
本例使用ASC与COUNT 10取得范围内按距离排序的最多十项,没有使用ANY提前终止选项。热点区域门店很多时仍需评估搜索半径、返回数量与业务过滤成本,不能因为命令有COUNT就认为所有查询开销固定。
立即学习“PHP免费学习笔记(深入)”;


















