Laravel如何处理和验证JSON类型的数据库字段

Laravel通过$casts实现JSON字段自动转换，结合表单验证可安全操作JSON数据。1. $casts支持array、object等类型；2. 验证时用点语法访问嵌套字段；3. 迁移中使用$json()定义JSON字段；4. 建议避免深层查询，更新时可用DB::raw确保原子性。

在 Laravel 中处理 JSON 类型的数据库字段，结合模型属性转换和请求验证，可以实现安全、灵活的数据操作。Laravel 原生支持 JSON 字段，尤其在 MySQL 和 PostgreSQL 中表现良好。

启用 JSON 字段自动转换

Laravel 的 Eloquent 模型可以通过 $casts 属性将数据库中的 JSON 字段自动转换为 PHP 数组或对象，反之亦然。

例如，假设你有一个 users 表，其中包含一个名为 meta 的 JSON 字段：

1. 在模型中定义 casts：

class User extends Model
{
    protected $casts = [
        'meta' => 'array', // 自动转为数组
    ];
}

设置后，读取 $user->meta 会得到一个 PHP 数组，赋值数组时也会自动编码为 JSON 存入数据库。

2. 支持的 cast 类型：

• 'array'：转换为数组
• 'object'：转换为 stdClass 对象
• 'collection'：转换为 Laravel 集合
• 'json'：确保始终以 JSON 格式存储（不自动解码）

验证 JSON 字段内容

虽然数据库字段是 JSON，但你通常需要验证其内部结构。Laravel 的表单请求验证支持对数组字段进行精细控制。

比如要验证 meta.address 是必填字符串：

public function rules()
{
    return [
        'meta' => 'required|array',
        'meta.name' => 'string|max:255',
        'meta.email' => 'email',
        'meta.address' => 'required|string|min:5',
    ];
}

Laravel 会自动识别点语法访问数组深层字段，非常适合验证 JSON 内容。

嵌套数组验证示例：

Programming Helper

AI代码自动生成器，在AI的帮助下更快地编程

下载

若 meta.skills 是一个字符串数组：

'meta.skills.*' => 'string|max:50'

这表示每个 skills 数组项都必须是不超过 50 字符的字符串。

数据库迁移与 JSON 字段

创建表时声明 JSON 类型字段：

Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->json('meta'); // 显式定义 JSON 类型
    $table->timestamps();
});

MySQL 从 5.7 开始原生支持 JSON 类型，PostgreSQL 使用 jsonb。Laravel 会根据数据库类型生成合适语法。

也可使用 text 类型存储 JSON，但推荐使用 json 以获得数据库层校验和索引支持（如 MySQL 的虚拟字段索引）。

实际操作建议

1. 避免在 where 条件中频繁查询 JSON 深层字段，性能较差。必要时可提取关键字段做冗余存储。

2. 更新部分 JSON 内容 可直接赋值子键：

$user->meta['address'] = 'New York';
$user->save();

3. 若需原子性更新，可使用 DB::raw：

User::where('id', 1)->update([
    'meta' => DB::raw("JSON_SET(meta, '$.address', 'Boston')")
]);