在 Lar*el Eloquent 中高效查询 JSON 数组字段的教程

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

在 Lar*el Eloquent 中高效查询 JSON 数组字段的教程

2025-11-14

浏览次数：次

返回列表

在 Laravel Eloquent 中高效查询 JSON 数组字段的教程

本文旨在解决 lar*el eloquent 在查询 json 数组字段时遇到的路径解析问题。当需要根据 json 数组中特定索引的值进行筛选时，eloquent 的 `wherejsondoesntcontain` 或 `where` 方法可能因生成错误的 sql 路径（例如 `$."key"` 而非 `$[index]`）而失效。文章将详细解释此问题，并提供使用 `whereraw` 结合 `json_extract` 的有效解决方案，同时指出 lar*el 9.0 及更高版本对此的改进。

Lar*el Eloquent 查询 JSON 数组字段：问题与解决方案

在 Lar*el 应用开发中，我们经常会遇到需要存储和查询 JSON 类型数据的情况。Eloquent ORM 提供了便捷的方法来处理 JSON 字段，例如 whereJsonDoesntContain 或使用 -> 运算符直接访问 JSON 路径。然而，当 JSON 字段存储的是数组，并且我们需要根据数组的特定索引值进行筛选时，可能会遇到意料之外的行为。

问题描述：Eloquent 对 JSON 数组路径的误解

考虑一个 Book 模型，其中包含一个 readings 字段，该字段是一个 JSON 数组，记录了每个月书籍的阅读量，例如 [1, 0, 3, 2, 5, 5, 2, 1, 3, 0, 0, 2]。我们希望查询每个月中阅读量不为零（即有阅读量）的书籍。

直观上，我们可能会尝试使用 whereJsonDoesntContain 方法，如下所示：

for ($i = 1; $i <= 12; $i++) {
    // 尝试查询第 $i-1 个月阅读量不为0的书籍
    $books = Book::whereJsonDoesntContain('readings->'. ($i - 1), 0)->get();
    // ...
}

或者使用更通用的 where 方法：

for ($i = 1; $i <= 12; $i++) {
    $books = Book::where('readings->'. ($i - 1), '!=', 0)->get();
    // ...
}

然而，这些查询在实际执行时可能无法返回预期的结果。原因是 Lar*el 在内部将这些 Eloquent 调用转换为 SQL 查询时，对于 JSON 数组的索引路径处理存在偏差。

例如，Book::whereJsonDoesntContain('readings->3', 0) 会被转换为类似于以下 SQL 语句：

SELECT * FROM books WHERE NOT JSON_CONTAINS(`readings`, '0', '$."3"')

而 Book::where('readings->3', '!=', 0) 则会被转换为：

SELECT * FROM books WHERE JSON_UNQUOTE(JSON_EXTRACT(`readings`, '$."3"')) != '0'

问题在于 SQL 的 JSON 函数（如 JSON_CONTAINS 或 JSON_EXTRACT）在访问数组元素时，需要使用 $[index] 这样的路径格式，而不是 $."key"。Lar*el 默认将 -> 后面的数字视为对象键，导致生成的 SQL 路径不正确，从而无法准确查询 JSON 数组中的特定索引。

解决方案：使用 whereRaw 和 JSON_EXTRACT

为了正确地查询 JSON 数组的特定索引，我们需要绕过 Eloquent 自动生成的路径，直接使用 whereRaw 方法来构造 SQL 语句。通过 JSON_EXTRACT 函数，我们可以精确地指定数组元素的路径 $[index]。

Perplexity

Perplexity是一个ChatGPT和谷歌结合的超级工具，可以让你在浏览互联网时提出问题或获得即时摘要

302

查看详情

以下是修正后的查询方法：

for ($i = 0; $i <= 11; $i++) { // 月份索引从0到11
    // 使用 whereRaw 和 JSON_EXTRACT 来查询指定月份阅读量不为0的书籍
    $books = Book::whereRaw("JSON_EXTRACT(`readings`, '\$[$i]') != 0")->get();
    // ...
}

代码解释：

for ($i = 0; $i
Book::whereRaw(...): 允许我们直接编写原始 SQL 条件。
JSON_EXTRACT(\readings`, '\$[$i]')`: 这是关键部分。
- readings: 是你的 JSON 字段名。
- '\$[$i]': 这是正确的 JSON 路径表达式。
  - \$: 在 PHP 字符串中，$ 需要转义，以确保它被视为 SQL 路径的一部分，而不是 PHP 变量。
  - [$i]: 表示访问 JSON 数组中索引为 $i 的元素。
!= 0: 筛选出该月阅读量不为零的记录。

通过这种方式，生成的 SQL 语句将是正确的，能够准确地从 JSON 数组中提取指定索引的值进行比较。

注意事项与版本兼容性

数据库兼容性：JSON_EXTRACT 和 JSON_CONTAINS 等 JSON 函数是 MySQL 5.7+、PostgreSQL 9.4+ 等现代关系型数据库支持的特性。请确保你的数据库版本支持这些函数。
性能考量：对 JSON 字段进行查询通常会比查询普通列的性能开销大。如果查询频率高且数据量大，可以考虑将关键数据点提取为单独的列，或者为 JSON 字段创建合适的索引（例如，MySQL 8.0+ 支持 JSON 路径索引）。
Lar*el 9.0+ 的改进：值得注意的是，Lar*el 9.0 及更高版本对 JSON 数组路径的处理进行了改进。从 Lar*el 9.0 开始，你可以通过以下语法正确地访问 JSON 数组元素：
```
// 在 Lar*el 9.0+ 中，这将正确生成 $[3] 这样的路径
Book::whereJsonDoesntContain('readings->[3]', 0);
```
这意味着在较新版本的 Lar*el 中，你可能不再需要 whereRaw 来处理这种特定场景。然而，了解 whereRaw 的用法仍然是处理复杂或特定数据库函数查询时的重要技能。

总结

在 Lar*el Eloquent 中查询 JSON 数组字段的特定索引时，由于 Eloquent 早期版本对 JSON 路径解析的限制，直接使用 whereJsonDoesntContain 或 where 可能会生成错误的 SQL。通过 whereRaw 结合 JSON_EXTRACT 函数，并使用正确的 '$[index]' 路径语法，可以有效地解决这个问题。对于使用 Lar*el 9.0 及更高版本的开发者，框架本身已经对此进行了优化，提供了更简洁的语法支持。在选择解决方案时，应根据你的 Lar*el 版本和数据库兼容性进行权衡。

以上就是在 Lar*el Eloquent 中高效查询 JSON 数组字段的教程的详细内容，更多请关注php中文网其它相关文章！

# 转换为 # 长期推广营销策略 # 莆田在线推广网站 # 渌口区企业营销推广公司 # 永兴网站建设推广 # 网站后台建设管理 # seo引流教学 # 萍乡营销推广欢迎来电 # 关键词排名效果费用如何 # 推广口碑营销排名靠前 # 网络推广是不是营销策划 # 不为 # 怎么做 # 运算符 # mysql # 这是 # 是一个 # 组中 # 的是 # 更高 # 多条 # 应用开发 # ai # json # js # laravel # php