PHP怎么使用Eloquent GIS Queries地理信息系统查询_Laravel空间数据高级操作【方法】-php教程-PHP中文网

laravel原生eloquent不支持postgis空间函数，须用db::raw()拼接sql或借助staudenmeir/eloquent-spatial包；核心问题在于srid不匹配、几何类型错误及索引失效，正确做法是统一使用wgs84（srid=4326）并配合st_distancesphere和gist索引。

php怎么使用eloquent gis queries地理信息系统查询_laravel空间数据高级操作【方法】

PHP中Eloquent如何执行PostGIS空间查询

直接说结论：Laravel原生Eloquent不支持地理空间函数，必须通过DB::raw()拼接PostGIS SQL，或借助第三方包（如staudenmeir/eloquent-spatial）补全模型层能力。硬套where()或whereRaw()写ST_DWithin之类函数会报错或返回空——因为Eloquent默认把几何字段当普通字符串处理，不触发PostGIS类型转换。

为什么`whereRaw('ST_Contains(...)')`常返回空结果

核心原因是PostGIS函数对坐标系、几何类型、SRID（空间参考系统ID）极其敏感，而Eloquent默认不校验也不转换：

数据库表中location字段是GEOMETRY类型但没设SRID，而查询里用ST_Point(116.4, 39.9)默认生成WGS84（SRID=4326），类型不匹配直接短路
ST_Contains第一个参数必须是多边形（POLYGON），传入POINT会静默失败
没调用ST_SetSRID()和ST_Transform()做坐标系对齐，比如地图瓦片用Web Mercator（SRID=3857），而GPS坐标是WGS84（SRID=4326）

正确写法示例（查某个多边形内所有门店）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

DB::table('stores')
    ->whereRaw('ST_Contains(?, location)', [
        DB::raw("ST_SetSRID(ST_GeomFromText('POLYGON((116.3 39.8, 116.5 39.8, 116.5 40.0, 116.3 40.0, 116.3 39.8))'), 4326)")
    ])
    ->get();

用`staudenmeir/eloquent-spatial`简化模型操作

这个包不是“魔法”，它只是帮你把ST_*函数封装成Eloquent可链式调用的方法，底层仍是DB::raw()。关键点在于：必须手动在模型中声明几何字段和SRID。

安装后，在模型里加use Spatially;和protected $spatialFields = ['location'];
必须显式设置SRID：protected $spatialSrid = 4326;，否则near()等方法生成的SQL会缺ST_SetSRID
near()默认用ST_DWithin，但单位是“度”（非米），查1公里范围要换算：->near($point, 0.01)（粗略估算，1度≈111km）
想按真实米计算，得改SQL：->whereRaw('ST_DWithin(location, ST_SetSRID(ST_MakePoint(?, ?), 4326), ?)', [$lng, $lat, 1000])

PostGIS索引失效的典型场景

加了GIST索引却没走索引，90%是因为查询时没保持几何类型一致：

字段定义是GEOMETRY(POINT, 4326)，但查询里用ST_GeomFromGeoJSON()生成的几何没指定SRID，PostgreSQL拒绝使用索引
用ST_Transform()动态转坐标系（如ST_Transform(location, 3857)），索引失效——必须对转换后字段单独建索引
在WHERE里对几何字段做函数运算（如ST_Buffer(location, 0.001)），索引失效；应把函数放在参数侧，如ST_Within(location, ST_Buffer($polygon, 0.001))

真正省事的做法：所有入库坐标统一存WGS84（SRID=4326），查询也用4326，距离用ST_DistanceSphere()（返回米），再配合GIST索引——这是最不容易踩坑的组合。