从 ES|QL 到 PHP 对象

亲身体验 Elasticsearch：深入了解我们的示例笔记本，开始免费云服务试用，或立即在您的本地计算机上试用 Elastic。

从 elasticsearch-phpv8.13.0开始，您可以执行ES|QL查询，并将结果映射到stdClass或自定义类的 PHP 对象。

ES|QL

ES|QL是 Elasticsearch 8.11.0 中引入的一种新的 Elasticsearch 查询语言。目前，它还处于技术预览阶段。它为过滤、转换和分析存储在 Elasticsearch 中的数据提供了一种强大的方法。

它利用"管道" (|) 来逐步操作和转换数据。通过这种方法，用户可以进行一系列操作，其中一个操作的输出将成为下一个操作的输入，从而实现复杂的数据转换和分析。

例如，下面的查询返回sample_data 索引的前 3 个文档（行）：

使用案例：官方 PHP 客户端中的 ES|QL 功能

为了说明在官方 PHP 客户端中开发的 ES|QL 功能，我们在 Elasticsearch 中存储了一个包含 81,828 本图书（54.4 MB）的CSV 文件，其中包括以下信息：

我们从公开的亚马逊图书评论数据集中提取了这份清单。

我们使用以下 Elasticsearch 映射创建了books 索引：

rating 值是从 2.9 GB 的Books_rating.csv文件中提取的评论排名平均值。

在这里，你可以找到我们用来批量导入 Elasticsearch 中所有图书的 PHP 脚本。使用 PHP 8.2.17 进行批量操作耗时 7 秒，占用 28 MB 内存。使用建议的映射后，Elasticsearch 中的索引大小约为 62 MB。

将 ES|QL 结果映射到 PHP 对象或自定义类

我们可以使用esql()->query() 端点在 PHP 中执行 ES|QL 查询。查询结果是一个表格数据结构。这在 JSON 中使用columns 和values 字段来表示。在columns 字段中，我们有name 和type 的定义。

下面是一个 ES|QL 查询示例，用于检索斯蒂芬-金著作中按用户评论排名排序的前 10 本书籍：

来自 Elasticsearch 的 JSON 结果如下：

在这个例子中，我们有 6 个与一本书相关的属性（作者、描述、出版商、评分、标题、年份）和 10 个结果，都是斯蒂芬-金的书。

这里列出了 ES|QL 支持的所有类型。

$result 响应对象可以数组、字符串或对象的形式访问（更多信息，请参见此处）。

使用对象接口，我们可以使用属性和索引访问值。例如，$result->values[0][4] 返回列表中第一本书（0）的书名（4），$result->values[1][3] 返回第二本书（1）的等级分（3），等等。请记住，PHP 中数组的索引是从 0 开始的。

对于某些使用情况，这个接口已经足够好了，但大多数情况下，我们希望得到一个对象数组的结果。

要将结果映射到对象数组中，我们可以使用 elasticsearch-php 的新功能mapTo()。

该功能可直接在Elasticsearch 响应对象中使用。这意味着您可以通过以下方式访问它：

如果您有一个自定义的图书类，可以使用它来映射结果，如下所示：

如果您的类除了 ES|QL 结果中包含的属性外还有其他属性，这也同样有效。mapTo() 函数将只使用作为 ES|QL 结果列返回的属性。

您可以在此下载本文中报告的所有示例。

常见问题