php中应使用原生数组构造elasticsearch dsl，避免json字符串拼接；动态添加must/filter条件并区分相关度计算与过滤；聚合需用keyword字段且明确指定size等参数。
在PHP项目中使用Elasticsearch时，直接拼接原始JSON格式的查询DSL容易出错、难以维护，尤其当条件动态变化（如多字段过滤、分页、聚合嵌套）时，手写数组结构极易漏键、错嵌套层级或类型不匹配，导致500错误或返回空结果。
用原生PHP数组构造DSL主体结构
先定义一个基础查询骨架，用标准PHP关联数组表示DSL最外层结构，避免字符串拼接引发的引号逃逸问题。
创建空数组 $dsl = []；
手动设置顶层键：$dsl['query'] = ['bool' => ['must' => []]]; $dsl['from'] = 0; $dsl['size'] = 20;
这一步必须用数组而非json_decode('{"query":{...}}')，因为后续要动态追加条件——【JSON字符串无法直接push元素到嵌套数组】。
动态添加match查询条件
方法一：单字段精确匹配
向 $dsl['query']['bool']['must'][] 追加 ['match' => ['title' => 'PHP教程']]；
方法二：带operator的多词匹配
追加 ['match' => ['content' => ['query' => '框架 DSL', 'operator' => 'and']]]；
注意：match查询默认是or行为，不显式设operator=and时，'PHP框架'会匹配含任一词的文档，不是你想要的完整短语。
组合filter提升性能与可缓存性
第一步：把时间范围过滤移到filter上下文
$dsl['query']['bool']['filter'][] = ['range' => ['created_at' => ['gte' => '2023-01-01']]]；
第二步：添加terms过滤多个ID
$dsl['query']['bool']['filter'][] = ['terms' => ['status' => [1, 2, 3]]]；
第三步：确保filter和must不混用——【filter里不能放match、should等影响相关度的子句】，否则ES会忽略cache或报错。
嵌套聚合生成分面统计
在$dsl中新增aggs键：$dsl['aggs'] = ['by_tag' => ['terms' => ['field' => 'tag.keyword', 'size' => 10]]]；
若需按日期直方图聚合，替换为：['date_histogram' => ['field' => 'created_at', 'calendar_interval' => 'month']]；
keyword字段必须显式声明，text字段默认不支持terms聚合——不加.keyword后缀会返回空buckets。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
