本文旨在讲解如何在 Laravel 5.8 及以上版本中，有效地查询包含 JSON 数据的数据库列，特别是针对 form_id 的精准匹配。我们将深入探讨 whereJsonContains 和 where 方法在 JSON 查询中的应用，并提供清晰的代码示例，助你轻松掌握 JSON 数据查询技巧。
在 Laravel 中，当数据库列存储 JSON 数据时，可以使用其提供的 JSON 查询功能来检索特定数据。本文将以 meta 列包含 {"form_id":31} 格式的 JSON 数据为例，演示如何查询所有 form_id 匹配特定值的记录。
使用 whereJsonContains 方法
whereJsonContains 方法用于检查 JSON 列是否包含指定的 JSON 片段。 适用于需要查找包含特定键值对的记录。
$formId = request()->id;
$query->whereJsonContains('meta->form_id', $formId);这段代码会查询 meta 列中 form_id 键包含 $formId 值的记录。例如，如果 $formId 为 31，则会返回 meta 列值为 {"form_id":31} 的记录。
注意事项:
- whereJsonContains 会检查整个 JSON 对象是否包含给定的值。如果你的JSON结构比较复杂，并且需要匹配多个条件，这个方法可能不适用。
使用 where 方法进行精确匹配
如果需要进行精确的 JSON 值匹配，可以直接使用 where 方法。
$formId = request()->id;
$query->where('meta->form_id', $formId);这段代码会查询 meta 列中 form_id 键的值完全等于 $formId 的记录。例如，如果 $formId 为 31，则会返回 meta 列值为 {"form_id":31} 的记录。
注意事项:
- where 方法进行的是精确匹配，这意味着 JSON 值的类型和内容必须完全一致。
- 确保数据库支持 JSON 列类型。MySQL 5.7.22+ 和 PostgreSQL 9.3+ 均支持 JSON 列类型。
示例代码
以下是一个完整的示例，展示如何在 Laravel 控制器中使用 JSON 查询：
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\YourModel; // 替换成你的模型
class YourController extends Controller
{
public function search(Request $request)
{
$formId = $request->id;
$results = YourModel::query()
->where('meta->form_id', $formId) // 使用 where 进行精确匹配
// ->whereJsonContains('meta->form_id', $formId) // 或者使用 whereJsonContains
->get();
return response()->json($results);
}
}总结：
- 使用 whereJsonContains 方法来检查JSON列是否包含指定的值。
- 使用 where 方法进行JSON值的精确匹配。
- 确保你的数据库支持JSON列类型。
- 根据实际需求选择合适的查询方法。
通过本文的讲解，你应该能够掌握在 Laravel 中查询 JSON 数据的基本方法，并能够根据实际情况选择合适的查询方式。更多关于 Laravel JSON 查询的信息，请参考 Laravel 官方文档。
