如何编写Laravel Migration在PostgreSQL中创建无PostGIS扩展的point列存储经纬度坐标
无PostGIS依赖的PostgreSQL原生point列Laravel迁移实现
核心前提:PostgreSQL 内置支持 point 坐标类型,完全不需要启用、安装PostGIS空间扩展,整个实现过程与空间扩展能力无任何绑定关系。
实现思路
Laravel 原生Schema构建器内置的 point() 列方法,默认生成依赖PostGIS的geometry空间类型定义,不符合无PostGIS的开发要求。因此需要绕过内置空间类型的封装,直接将PostgreSQL原生point类型的列定义以原生SQL片段的形式嵌入建表语句,实现零依赖的列创建。
标准版本迁移脚本(Laravel 7+)
<?php use Illuminate\Database\Migrations\Migration; use Illuminate\Database\Schema\Blueprint; use Illuminate\Support\Facades\Schema; return new class extends Migration { /** * 执行迁移 */ public function up(): void { Schema::create('geo_locations', function (Blueprint $table) { $table->id(); $table->string('site_name')->comment('点位名称'); // 核心逻辑:直接定义PostgreSQL原生point类型列,无PostGIS依赖 $table->raw('coordinates point NOT NULL COMMENT \'经纬度坐标(经度,纬度)\''); $table->timestamps(); }); // 可选:为point列创建原生支持的索引,同样不需要PostGIS DB::statement('CREATE INDEX geo_locations_coordinates_idx ON geo_locations USING btree (coordinates)'); } /** * 回滚迁移 */ public function down(): void { Schema::dropIfExists('geo_locations'); } };
低版本兼容写法(Laravel <7)
如果使用的Laravel版本不支持Blueprint的raw()方法,可以先创建基础表结构,再通过原生SQL语句追加point类型列:
public function up() { // 创建不含坐标列的基础表 Schema::create('geo_locations', function (Blueprint $table) { $table->id(); $table->string('site_name')->comment('点位名称'); $table->timestamps(); }); // 追加原生point类型列 DB::statement("ALTER TABLE geo_locations ADD COLUMN coordinates point NOT NULL COMMENT '经纬度坐标(经度,纬度)'"); // 创建坐标列索引 DB::statement('CREATE INDEX geo_locations_coordinates_idx ON geo_locations USING btree (coordinates)'); }
关键注意事项
- 禁止直接使用Laravel内置的
$table->point('coordinates')方法,该方法生成的是PostGIS依赖的geometry类型定义,无PostGIS环境下会直接报类型不存在的错误。 $table->raw()方法传入的SQL片段会直接拼接至最终的建表语句中,生成的point类型属于PostgreSQL核心内置类型,无需额外扩展加载即可识别。- 原生point类型的存储格式为
(经度值, 纬度值),写入数据时直接传入符合格式的字符串即可,例如'(121.473, 31.230)',无需借助PostGIS的空间解析函数。 - 回滚逻辑与常规表操作完全一致,不需要额外删除关联的扩展、函数或类型。
内容的提问来源于stack exchange,提问作者sufyan
相关产品推荐
相关产品推荐

