Laravel Backpack如何正确存储MySQL POINT几何类型数据

Backpack默认的字段读写逻辑不会自动处理MySQL空间类型转换，直接提交原始坐标/数组会触发字段类型不匹配报错，结合你使用的Grimzy spatial扩展，按以下步骤配置即可： #

1. 模型层基础配置 #

首先在对应模型中引入SpatialTrait，声明空间字段，让模型自动处理空间数据的读写：

// 模型头部引入依赖
use Grimzy\LaravelMysqlSpatial\Eloquent\SpatialTrait;
use Grimzy\LaravelMysqlSpatial\Types\Point;

class MonitoringPoint extends Model
{
    use SpatialTrait;
    // 注册所有空间类型字段
    protected $spatialFields = [
        'MonitoringPointGISLocation'
    ];
}

2. 控制器字段配置与数据转换 #

不要直接把POINT类型字段绑定为普通表单输入字段，拆分经纬度为独立表单项，通过CRUD的保存钩子做类型转换：

// 表单字段配置 经纬度拆分为独立数字输入项，精度按需调整
CRUD::field('gis_lat')
    ->label('纬度')
    ->type('number')
    ->attributes(['step' => '0.000001', 'min' => '-90', 'max' => '90']);
CRUD::field('gis_lng')
    ->label('经度')
    ->type('number')
    ->attributes(['step' => '0.000001', 'min' => '-180', 'max' => '180']);

// 注册创建/更新前置回调，构造Point实例赋值
CRUD::createOrUpdate(function ($entry, $input) {
    // Point构造参数顺序为 纬度在前、经度在后，和GeoJSON坐标顺序相反
    $point = new Point(
        (float)$input['gis_lat'],
        (float)$input['gis_lng']
    );
    $entry->MonitoringPointGISLocation = $point;
    // 移除临时经纬度字段，避免模型查询不存在的数据库字段
    $entry->unsetAttribute('gis_lat');
    $entry->unsetAttribute('gis_lng');
    return $entry;
});

// 列表列展示配置，把Point实例转为可读字符串
CRUD::column('MonitoringPointGISLocation')
    ->label('GIS Location')
    ->value(function ($entry) {
        return $entry->MonitoringPointGISLocation 
            ? sprintf("经度:%.6f, 纬度:%.6f", 
                $entry->MonitoringPointGISLocation->getLng(),
                $entry->MonitoringPointGISLocation->getLat()
              )
            : '-';
    });

如果前端直接提交GeoJSON格式的坐标数组，直接在createOrUpdate回调里复用你之前的坐标取值逻辑即可，不需要拆分独立经纬度字段。

3. 编辑场景数据回填 #

在编辑方法中把已存的Point数据拆分填充到表单字段，避免编辑时输入项为空：

public function edit($id)
{
    $response = parent::edit($id);
    $entry = $this->crud->entry;
    if ($entry->MonitoringPointGISLocation) {
        CRUD::field('gis_lat')->value($entry->MonitoringPointGISLocation->getLat());
        CRUD::field('gis_lng')->value($entry->MonitoringPointGISLocation->getLng());
    }
    return $response;
}

避坑提示：必须把坐标值实例化为Grimzy提供的Point对象再赋值给模型字段，不能直接传数组、字符串格式的坐标，否则会触发数据库空间字段类型校验报错。

内容的提问来源于stack exchange，提问作者Andrew Marshall