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

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

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

如何查询JSON字段

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

基本语法：

• 查询 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字段：

如何更新JSON字段

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

ColorMagic

AI调色板生成工具

下载

• 在模型中定义 cast：
  

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

• 更新整个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([<br>   'profile->age' => 30,<br>   'profile->city' => 'Guangzhou'<br>]);

使用whereJsonContains进行复杂查询

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

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

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

在模型中安全操作JSON属性

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

• 定义 accessors 获取格式化数据：
  

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

• 使用 mutators 设置值前处理：
  

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

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