mysql 5.7+ 创建空间索引必须使用 point 类型字段并显式指定 srid（如4326），建表时需定义 point srid 4326 not null 并添加 spatial index，修改现有表须先 modify 加 srid 再 add spatial index；查询需用 st_distance_sphere() 配合空间索引且左侧为字段、右侧为常量 point，插入须用 st_pointfromtext('point(lng lat)', 4326) 确保坐标顺序正确。
MySQL 5.7+ 中 PHP 创建空间索引必须用 POINT 字段和 SRID
PHP 本身不直接“添加空间索引”，实际是通过 PDO 或 MySQLi 执行 SQL 建表或修改表结构。关键前提是：MySQL 版本 ≥ 5.7，且字段类型必须是 POINT（或其他空间类型如 POLYGON），并显式指定 SRID（如 SRID 4326）。MySQL 5.6 不支持 SRID，强行建空间索引会报错 ER_SPATIAL_MUST_HAVE_SRID。
常见错误现象：SQLSTATE[HY000]: General error: 3981 Field 'location' has no SRID value, but it is required for column with spatial type.
- 建表时必须写
POINT SRID 4326，不能只写POINT -
NOT NULL是强建议（否则插入NULL点会导致空间索引失效或查询异常） - 字段名不要用
geometry（这是 MySQL 内置关键字，易触发语法歧义）
PHP 中执行建表语句的正确写法（PDO 示例）
用 PDO 连接后，直接执行带 GEOMETRY 类型和 SPATIAL INDEX 的建表 SQL。注意：ST_PointFromText() 和 ST_GeomFromText() 在插入时才用，建表阶段只关心字段定义和索引声明。
CREATE TABLE `places` ( `id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY, `name` VARCHAR(100) NOT NULL, `location` POINT SRID 4326 NOT NULL, SPATIAL INDEX `idx_location` (`location`) ) ENGINE=InnoDB;
如果表已存在，需先修改字段加 SRID，再加索引：
立即学习“PHP免费学习笔记（深入）”；
ALTER TABLE places MODIFY location POINT SRID 4326 NOT NULL;ALTER TABLE places ADD SPATIAL INDEX idx_location (location);
这两步不能合并——MySQL 要求字段带 SRID 后才能建空间索引。
ST_Distance_Sphere() 查询必须配合空间索引才有效
很多人建了空间索引却没提速，是因为查询没走索引。MySQL 对空间函数有严格要求：ST_Distance_Sphere() 在 WHERE 或 HAVING 中使用时，只有左侧是字段、右侧是常量 POINT，且字段上有空间索引，才会触发索引查找。
正确示例（能用上 idx_location）：
SELECT id, name,
ST_Distance_Sphere(location, ST_PointFromText('POINT(116.404 39.915)', 4326)) AS dist
FROM places
WHERE ST_Within(location, ST_Buffer(ST_PointFromText('POINT(116.404 39.915)', 4326), 1000))
ORDER BY dist LIMIT 10;
-
ST_Within+ST_Buffer是推荐的“先粗筛再精排”写法，比全表算ST_Distance_Sphere快一个数量级 - 所有 WKT 字符串（如
'POINT(116.404 39.915)'）必须和字段 SRID 一致（这里是 4326） - PHP 中拼接时，务必用
floatval()处理经纬度，避免科学计数法或尾部空格导致 WKT 解析失败
PHP 插入点数据时别漏掉 ST_PointFromText()
不能直接 INSERT INTO ... VALUES (..., 'POINT(116.404 39.915)') —— 这会存成字符串，不是空间对象，索引完全无效。
必须用 ST_PointFromText() 包裹，并指定 SRID：
$lat = 39.915;
$lng = 116.404;
$stmt = $pdo->prepare("INSERT INTO places (name, location) VALUES (?, ST_PointFromText(?, 4326))");
$stmt->execute(['北京站', "POINT($lng $lat)"]);
注意顺序：POINT(longitude latitude)，不是 (lat lng)，反了会导致位置偏移上千公里。
更安全的做法是用 ST_GeomFromGeoJSON()（需 MySQL 5.7.8+），它自动校验坐标顺序和范围，但 PHP 侧要确保传入的是标准 GeoJSON Point 字符串。
空间索引生效与否，不取决于 PHP 代码多漂亮，而在于建表语句是否带 SRID、插入是否用空间函数、查询是否满足索引使用条件。漏掉任意一环，就只是个耗资源的装饰品。
