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

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

如何查询JSON字段

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();

如何更新JSON字段

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

LobeHub

LobeChat brings you the best user experience of ChatGPT, OLLaMA, Gemini, Claude

302

查看详情

• 在模型中定义 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>}

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

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

以上就是Laravel如何处理JSON字段的查询和更新_Laravel JSON列操作与查询技巧的详细内容，更多请关注php中文网其它相关文章！