Laravel支持JSON字段操作，通过迁移定义json类型，使用->语法查询和更新嵌套值，结合where、update等方法实现精准操作，Eloquent模型可通过casts将JSON自动转为数组，提升开发效率。
Laravel 对数据库中 JSON 字段的操作支持非常友好，尤其是在 MySQL 5.7+ 或 PostgreSQL 等支持 JSON 的数据库中。你可以直接使用 Eloquent ORM 或查询构造器来查询和更新 JSON 字段，无需手动序列化或反序列化。下面详细介绍 Laravel 中如何处理 JSON 字段的查询与更新。
1. 数据库迁移中定义 JSON 字段
在创建数据表时，可以使用 $table->json() 方法定义一个 JSON 类型的字段：
Schema::create('users', function (Blueprint $table) {
$table->id();
$table->string('name');
$table->json('settings'); // 定义 JSON 字段
$table->timestamps();
});
2. 查询 JSON 字段
Laravel 支持通过 -> 操作符访问 JSON 字段中的键，适用于 where、orderBy、select 等常见操作。
查询 JSON 中的特定值：
// 查询 settings 中 language 为 'zh' 的用户
$users = DB::table('users')
->where('settings->language', 'zh')
->get();
// 使用 Eloquent
$users = User::where('settings->language', 'zh')->get();
嵌套查询：
// 查询 settings 中 preferences->theme 为 'dark' 的用户
User::where('settings->preferences->theme', 'dark')->get();
判断 JSON 字段是否包含某个键：
// MySQL: 使用 JSON_CONTAINS_PATH
User::whereJsonContains('settings', '->notifications')->get();
// 或检查嵌套路径是否存在
User::whereJsonContains('settings', '->preferences->email')->get();
模糊查询 JSON 字段中的数组：
// 假设 settings->roles 是一个数组，查找包含 'admin' 的用户
User::whereJsonContains('settings->roles', 'admin')->get();
3. 更新 JSON 字段
使用 update 方法结合 -> 语法可以直接更新 JSON 中的某个键。
更新单个 JSON 键：
DB::table('users')->where('id', 1)->update([
'settings->language' => 'en'
]);
User::where('id', 1)->update([
'settings->theme' => 'light'
]);
更新多个 JSON 字段：
User::where('id', 1)->update([
'settings->language' => 'en',
'settings->timezone' => 'UTC',
'settings->preferences->email' => true,
]);
追加数组元素（如添加角色）：
// 向 roles 数组中添加一个新角色
User::where('id', 1)->update([
'settings->roles' => DB::raw("JSON_ARRAY_APPEND(settings, '$.roles', 'editor')")
]);
注意：原生 SQL 函数如 JSON_ARRAY_APPEND、JSON_SET 等在复杂操作中很有用，但需确保数据库支持。
4. 在 Eloquent 模型中自动转换 JSON 字段
推荐将 JSON 字段设置为自动序列化/反序列化，这样在模型中可直接当作数组使用。
class User extends Model
{
protected $casts = [
'settings' => 'array', // 自动转为数组
];
}
设置后，可以直接操作：
$user = User::find(1); $user->settings['language'] = 'zh'; $user->save();
或者批量赋值：
$user->update([
'settings' => [
'language' => 'zh',
'theme' => 'dark',
'roles' => ['user', 'vip']
]
]);
这种写法更直观，适合业务逻辑复杂的场景。
5. 注意事项
- 确保数据库引擎支持 JSON 类型（MySQL 5.7+，PostgreSQL 9.3+）
- 使用 -> 查询时，右侧不能是变量表达式，只能是字面量
- 在使用 JSON 函数 时注意 SQL 注入风险，尽量避免拼接
- 如果字段可能为 NULL，查询前应先判断是否存在
