PHP连接Elasticsearch需使用官方elasticsearch/elasticsearch包，通过ClientBuilder配置hosts、重试等参数，并支持Basic Auth；写入须注意ID、mapping和refresh策略；搜索需区分match与term查询类型；解析结果需遍历$result'hits'并处理高亮与total结构。
PHP怎么连接Elasticsearch服务
PHP本身不内置Elasticsearch客户端，必须通过第三方HTTP客户端发起请求，最稳妥的方式是用官方维护的 elasticsearch/elasticsearch Composer 包。它底层基于 GuzzleHttp\Client，但封装了索引、搜索、批量写入等常用操作，避免手动拼接REST API URL和处理JSON响应。
常见错误是直接用 file_get_contents() 或 curl_init() 手写请求——容易漏掉认证头、超时控制、重试逻辑，且无法自动处理429（Too Many Requests）或503（Service Unavailable）这类ES特有状态码。
- 执行
composer require elasticsearch/elasticsearch安装 - 初始化客户端时显式指定
hosts和retryOnConflict参数，例如：$client = ClientBuilder::create() ->setHosts(['http://127.0.0.1:9200']) ->setRetries(2) ->build(); - 若ES启用了Basic Auth，需在host字符串里带上凭证：
'https://user:pass@127.0.0.1:9200'，否则返回401 Unauthorized
怎么往Elasticsearch写入PHP数据
写入不是简单 index() 就完事。ES对文档ID、映射（mapping）、刷新策略（refresh）非常敏感，PHP端不注意会导致查不到数据、字段类型冲突或性能骤降。
典型问题：用 index() 插入后立即搜索却无结果——因为默认 refresh 是1秒延迟；或者中文字段搜不出来——因为没配中文分词器，ES把整段当一个token切分。
立即学习“PHP免费学习笔记（深入）”；
- 插入单条用
index()，务必传id参数，否则ES自动生成UUID，后续更新困难：$params = [ 'index' => 'articles', 'id' => '123', 'body' => ['title' => 'PHP集成ES', 'content' => '...'] ]; - 批量写入必须用
bulk()，不要循环调index()，否则网络开销爆炸；body数组需按index+doc成对组织 - 首次建索引前，建议用
indices()->create()显式定义mapping，尤其是text字段要加"analyzer": "ik_smart"（如果装了ik分词插件）
PHP搜索时为什么返回空或结果不准
空结果不一定是数据没写进去，更可能是查询DSL写错、字段未启用搜索、或用了不匹配的查询类型。ES的 match 和 term 行为完全不同：前者走分词，后者精确匹配未分析字段。
比如对 status 字段（keyword类型）误用 match，ES会尝试分词，而keyword字段根本不可分，必然无命中；反过来，对 title（text类型）用 term，则因大小写/标点被归一化，也搜不到。
- 查全文内容用
match，查状态码、ID等确定值用term，别混用 - 调试时先用
GET /articles/_search?pretty在Kibana或curl里直连验证DSL是否生效 - PHP中构造查询体时，
query下必须嵌一层，不能把match直接当根键：$params = [ 'index' => 'articles', 'body' => [ 'query' => [ 'match' => ['title' => 'elasticsearch php'] ] ] ];
怎么处理Elasticsearch返回的PHP数组结构
ES返回的是嵌套很深的关联数组，hits → hits → _source 这三层最容易漏掉。新手常直接 foreach($result as $item)，结果遍历的是顶层元信息（took、timed_out等），根本拿不到文档数据。
另外，ES可能返回 _score、_id、_index 等元字段，如果业务代码直接 json_encode($item['_source']) 输出，前端拿到的是纯数据；但若需要高亮、排序依据或调试用ID，就得保留这些字段。
- 正确提取结果：
$result['hits']['hits']是文档数组，每个元素含_source（原始数据）、_score（相关度）、_id（文档ID） - 高亮内容在
$hit['highlight']['field_name'][0]，不是$hit['_source']['field_name']，且需在查询DSL里显式开启"highlight"配置 - 注意
total字段在7.x后是对象：$result['hits']['total']['value']，不再是整数
Content-Type: application/json，或者云服务商（如阿里云ES）强制要求HTTPS且校验域名白名单。这些不在PHP代码里，但不解决就永远连不上。 
