PHP本身不内置ES分词能力，所有分词由ES服务端完成；PHP仅构造DSL并发送请求，需正确调用_analyze API（如POST /index/_analyze含text和analyzer参数）或配置mapping指定analyzer，否则分词失效。
PHP 本身不内置 Elasticsearch 分词查询能力，所有分词行为实际由 Elasticsearch 服务端完成；PHP 只负责构造符合要求的查询 DSL 并发送请求。直接在 PHP 层“实现分词”是误解，真正要做的，是让 PHP 正确调用 ES 的 analyze API 或使用支持分词的查询类型（如 match、multi_match），并确保索引 mapping 配置了合适的 analyzer。
怎么用 PHP 调用 ES 的 analyze API 查看分词结果
调试分词最常用的方式是手动触发 analyze，确认文本被如何切分、是否过滤停用词、是否转小写等。PHP 通过 HTTP 请求调用即可，无需额外扩展：
- 必须指定
index参数（即使只查分词），否则 ES 会返回 400 错误：Missing required parameter [index] - 若想测试自定义 analyzer，需确保该 analyzer 已在目标索引的 mapping 中定义，或使用
analyzer字段显式传入（如"analyzer": "ik_smart"） - 推荐用
curl或GuzzleHttp\Client发送 POST 请求，body 是 JSON，例如：{"text": "快速检索文档", "analyzer": "ik_smart"} - 响应体中
tokens数组里的token字段就是实际分出的词项，注意检查start_offset和end_offset是否符合预期
PHP 发送 match 查询时为什么没分词或分词不准
根本原因几乎都出在 mapping 配置或字段类型上，而非 PHP 代码本身：
-
text类型字段默认启用标准分词器，但如果你把字段设为keyword类型，ES 就完全不分词，整个字符串当一个 term 处理 - 创建索引时未显式指定
analyzer，导致用了默认的standard，对中文基本无效——必须配合中文分词插件（如ik、pinyin）并正确配置analyzer - PHP 构造查询时写了
"query": {"match": {"title": "搜索关键词"}}，但后端索引里title字段 mapping 是keyword，此时查询等价于精确匹配，不会触发分词 - 使用
term查询代替match——term是底层 term 级别匹配，永远不分词，哪怕字段是text类型
PHP 使用 elasticsearch-php 客户端发 query 有哪些关键点
官方 elasticsearch-php 客户端（v8.x）封装了大部分操作，但几个地方极易出错：
立即学习“PHP免费学习笔记（深入）”；
- 连接初始化必须指定
hosts，且 host 地址末尾不要加/，否则可能报cURL error 6: Could not resolve host - 调用
$client->search()时，body必须是 PHP 关联数组，不是 JSON 字符串；客户端内部会json_encode，手动转成 JSON 会导致双重编码和 400 错误 - 中文分词查询务必检查
index参数是否传对，v8 客户端已废弃index在 URL 路径中写法，必须放在body或方法参数里，例如：$client->search(['index' => 'my_index', 'body' => [...]]) - 聚合查询或高亮（
highlight）需要字段在 mapping 中开启"store": true或"fielddata": true（对text字段），否则返回空或报错Fielddata is disabled on text fields
分词不是 PHP 做的，是 ES 做的；PHP 的角色只是精准传递意图。最容易忽略的，是 mapping 没配对、index 名写错、analyzer 名拼错——这三个地方一错，再正确的 PHP 代码也查不到结果。
