本文介绍如何在 Laravel 中封装一个通用的 save() 函数，安全、准确地将请求字段或指定值批量写入模型，避免因数组键类型判断错误导致属性赋值异常的问题。
本文介绍如何在 laravel 中封装一个通用的 `save()` 函数，安全、准确地将请求字段或指定值批量写入模型，避免因数组键类型判断错误导致属性赋值异常的问题。
在 Laravel 开发中，重复编写类似 $model->field = $request->field; $model->save(); 的代码不仅冗余，也降低了可维护性。为提升开发效率，我们常希望封装一个通用的 save() 辅助函数，支持混合传入字段名（自动从请求中获取）和显式键值对（如 'user_id' => 1）。但正如示例中所见，若未正确区分关联数组中的字符串键与数字索引键，会导致模型 attributes 数组结构错乱——例如将 'detail' 错误地作为数值索引 1 写入，而非键名为 'detail' 的属性。
根本原因在于：PHP 中使用 foreach ($fields as $key => $field) 遍历时，当 $fields 是索引数组（如 ['title', 'detail']），$key 为整型（0, 1, ...），而 gettype($key) === 'integer'；当为关联数组（如 'user_id' => 1），$key 为字符串。原逻辑中 if ($key == null) 判断无效（null 键极罕见且非预期），导致所有索引项被误当作“需从请求取值的字段名”，却错误地将 $field（即字符串 'detail'）直接赋给了 $class->$field，等价于 $class->detail = 'detail' —— 这显然不是我们想要的行为。
✅ 正确做法是：仅对整型键（即纯字段名列表）调用 get($field) 获取请求值；对字符串键则直接赋值 $class->$key = $field。优化后的函数如下：
function save(string $class, array $fields): void
{
$instance = new $class;
foreach ($fields as $key => $value) {
if (is_int($key)) {
// 索引项：视为字段名，从 request 中获取对应值
$instance->$value = request()->input($value, null);
} else {
// 关联项：$key 是属性名，$value 是待赋的值
$instance->$key = $value;
}
}
$instance->save();
}
// 使用示例：
save(Address::class, [
'title',
'detail',
'phone',
'address',
'user_id' => $user->id,
]);
⚠️ 注意事项：
-
安全性提醒：该函数未做字段白名单校验或请求验证，生产环境务必配合
Request类的validated()或$request->only([...])使用，防止 mass assignment 漏洞； -
推荐替代方案：Laravel 原生已提供更健壮的方式，如
Address::create($request->only(['title', 'detail', 'phone', 'address']) + ['user_id' => $user->id])，或结合fillable/guarded属性控制可批量赋值字段； -
扩展建议：可进一步增强函数支持 Eloquent 的
fill()+save()组合、事务包裹、或返回创建的模型实例以支持链式操作。
掌握 is_int($key) 这一关键判断，即可精准分离“字段名自动映射”与“显式属性赋值”两种场景，让简化函数真正可靠、简洁、符合直觉。
