PHP调用Elasticsearch的核心难点在于准确映射ES REST API，而非PHP语法本身；需注意版本兼容性（如ES 8.x需elasticsearch/elasticsearch:^8.4）、HTTPS/认证配置、host格式规范、DSL结构严格对齐、字段名大小写敏感、中文分词器配置及近实时特性导致的查询延迟。
PHP 调用 Elasticsearch（常被简称为 PHP+ES 或 PHPES）不是学“一门新语言”，而是掌握一个 HTTP 客户端如何跟 ES 服务通信。核心难点不在 PHP 语法，而在理解 ES 的 REST API 设计逻辑、数据建模方式，以及客户端如何把 PHP 数组/对象准确映射成 ES 所需的 JSON 请求体。
composer require elasticsearch/elasticsearch 装完就报错？
常见错误是版本不匹配或 PHP 环境不兼容：
- ES 8.x 默认启用 HTTPS + Basic Auth，而
elasticsearch/elasticsearch7.x 客户端默认不带认证逻辑，会卡在 401 或连接拒绝；建议明确指定版本：composer require elasticsearch/elasticsearch:^8.4（对应 ES 8.4+） - PHP 版本低于 8.0 时，8.x 客户端无法安装，得降级用
^7.4，但要注意 ES 7.x 已停止维护，生产环境不推荐 - Windows 下若提示
cURL error 60: SSL certificate problem，不是证书问题，而是客户端默认校验远端证书——临时解决：在ClientBuilder::create()后加->setSSLVerification(false)（仅开发环境）
ClientBuilder::create()->setHosts() 怎么填才不连不上？
ES 默认只监听 localhost，且从 8.0 开始强制启用安全模块，setHosts(['localhost:9200']) 很可能失败：
- 先确认 ES 是否真正运行：
curl -X GET "http://localhost:9200/"，返回 JSON 才算活；如果超时，检查elasticsearch.yml中是否设置了network.host: 0.0.0.0和http.port: 9200 - ES 8.x 默认开启 TLS，要用
https://localhost:9200，并传入证书路径或关闭校验（见上条） -
setHosts()支持数组，但不要混写协议：['http://localhost:9200', 'https://es.example.com:9200']是合法的；但['localhost', '9200']会被解析为两个独立 host，导致连接异常
search() 返回空 hits 或 No mapping found？
这不是 PHP 写错了，而是索引结构或查询 DSL 不匹配：
立即学习“PHP免费学习笔记（深入）”；
- ES 8.x 移除了
type概念，所有文档都属于_doc类型，但旧教程里还常见'type' => 'user'，删掉这一行，否则整个请求被拒 - 字段名大小写敏感，
['query']['match']['title']查不到数据，很可能是你存进去的是title_text或Title；用GET /my_index/_mapping确认实际字段名 - 没设
index参数时，search()默认查所有索引，容易误命中空索引；务必显式传'index' => 'my_index' - 中文搜索为空？默认 standard 分词器对中文是单字切分，效果差；建索引时要指定
ik_max_word等中文分词器，并确保插件已装、ES 重启过
最易被忽略的一点：ES 的文档写入是近实时（near real-time），index() 成功后立刻 search()，大概率查不到——加 'refresh' => 'true' 参数强制刷新，或等 1 秒再查。这和 MySQL 的“写完就能读”完全不同，得主动适应它的延迟模型。
