Laravel中HTML输入名与DB列名不一致时如何批量写入模型数据

当你不想逐行编写字段映射赋值、又想保留$request->all()的批量写入便利性时，优先用集中维护映射表+自动转换键名的方案，全程只需要维护一份字段对应关系，不需要重复写赋值逻辑。

核心实现方案 #

1. 单控制器内快速实现 #

只需要两步：先定义「前端表单name值 => 数据库列名」的映射数组，再自动转换请求数据的键名，直接传给create方法即可。

// 1. 集中维护字段映射关系，新增/修改对应关系只需要改这一个数组
$fieldMap = [
    'input_username' => 'name', // 前端<input name="input_username"> 对应DB的name列
    'form_age' => 'age',
    'user_mobile' => 'phone',
    'reserve_address' => 'address',
    // 所有字段按上面格式列在这里即可，不需要逐行写$request->xxx
];

// 2. 自动转换请求数据为模型可识别的键值对
$insertData = [];
foreach ($fieldMap as $formName => $dbColumn) {
    // 从请求中取对应表单字段的值，不存在则默认置为null
    $insertData[$dbColumn] = $request->input($formName);
}

// 3. 直接批量写入，和原来用$request->all()的体验一致
Model::create($insertData);

这个方案哪怕有上百个字段，也只需要在$fieldMap里加一行配置，没有重复代码。

2. 复用场景优化 #

如果这套字段映射在新增、编辑等多个接口里都要用到，可以把逻辑抽到自定义表单请求类中，避免重复写映射处理逻辑：
首先生成自定义Form Request，在里面增加获取映射后数据的方法：

// app/Http/Requests/UserStoreRequest.php
namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class UserStoreRequest extends FormRequest
{
    public function authorize()
    {
        return true; // 根据实际权限判断调整
    }

    public function rules()
    {
        return [
            // 写对应表单字段的校验规则即可
            'input_username' => 'required|string|max:255',
            'form_age' => 'required|integer',
        ];
    }

    // 新增方法，直接返回转换好的可入库数据
    public function getDbInsertData()
    {
        $fieldMap = [
            'input_username' => 'name',
            'form_age' => 'age',
            'user_mobile' => 'phone',
            'reserve_address' => 'address',
        ];

        $data = [];
        foreach ($fieldMap as $formName => $dbCol) {
            $data[$dbCol] = $this->input($formName);
        }
        return $data;
    }
}

之后在控制器里直接依赖注入这个请求类，一行代码就能完成写入：

public function store(UserStoreRequest $request)
{
    Model::create($request->getDbInsertData());
}

3. 少数字段不一致的极简方案 #

如果绝大多数表单name和DB列名一致，只有个别字段名不同，完全不需要写全量映射，直接基于$request->all()替换个别键名即可：

$data = $request->all();
// 只处理名称不一致的字段
$data['name'] = $data['input_username'];
unset($data['input_username']);
$data['phone'] = $data['user_mobile'];
unset($data['user_mobile']);

Model::create($data);

注意事项 #

• 模型的$fillable属性必须配置数据库实际列名，不要写前端表单的name值，否则会触发批量赋值保护报错。
• 不要直接把未做键名转换的$request->all()传入create方法，会因为数组键名和DB列名不匹配导致SQL报错，或者写入脏数据。

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