Laravel如何处理JSON字段的查询和更新_Laravel JSON列操作与查询技巧_网络技术

发布时间 - 2025-12-09 00:00:00 点击率：次

Laravel通过->操作符和$casts实现JSON字段的便捷查询与更新，支持条件筛选、字段提取、嵌套查询及whereJsonContains等高级用法，结合访问器与修改器可安全处理结构化数据。

在Laravel中操作数据库的JSON字段变得越来越常见，尤其是在需要灵活存储结构化数据的场景下。MySQL 5.7+ 和 PostgreSQL 等主流数据库都支持原生JSON类型，Laravel通过Eloquent和查询构造器提供了便捷的方式来查询和更新这些字段。

Laravel允许你使用->操作符来访问JSON字段中的值，这在where、select、orderBy等语句中都非常实用。

基本语法：

`users` 表有一个 `profile` JSON字段，内容如：{"age": 25, "city": "Beijing"}

查询 profile 中 age 等于 25 的用户：
User::where('profile->age', 25)->get();
模糊匹配 city 字段：
User::where('profile->city', 'like', '%jing%')->get();
嵌套JSON查询（如 profile 包含 {"address": {"district": "Haidian"}}）：
User::where('profile->address->district', 'Haidian')->get();

你也可以在 select 中提取JSON字段：

User::select('id', 'profile->city as city')->get();

Laravel会自动识别模型中定义为数组的属性，并将其序列化为JSON写入数据库。你可以在模型中配合 $casts 来实现自动转换。

在模型中定义 cast：

protected $casts = [
   'profile' => 'array'
];

更新整个JSON字段：
User::where('id', 1)->update(['profile' => ['age' => 30, 'city' => 'Shanghai']]);
只更新JSON中的某个键（推荐方式）：
User::where('id', 1)->update(['profile->age' => 30]);

同时更新多个JSON子字段：

User::where('id', 1)->update([
   'profile->age' => 30,
   'profile->city' => 'Guangzhou'
]);

当JSON字段是数组时，比如 tags: ["php", "laravel"]，你可以使用 whereJsonContains 来判断是否包含某个值。

查询包含 "laravel" 标签的用户：
User::whereJsonContains('profile->tags', 'laravel')->get();
PostgreSQL还支持多值包含，MySQL则有限制。

注意：在MySQL中，whereJsonContains 要求字段是有效的JSON数组，否则可能无法匹配。

结合 $casts 和访问器/修改器，可以更安全地处理JSON字段。

定义 accessors 获取格式化数据：

public function getCityAttribute()
{
   return $this->profile['city'] ?? null;
}

使用 mutators 设置值前处理：

public function setProfileAttribute($value)
{
   $this->attributes['profile'] = json_encode(array_filter($value));
}

这样可以在保存前过滤空值或做数据清洗。

基本上就这些常用操作。Laravel对JSON字段的支持已经很成熟，合理使用能大幅提升开发效率，特别是在配置、用户偏好、动态表单等场景下非常实用。关键是记得设置$casts，并熟悉->语法和whereJsonContains等高级查询方法。