PHP 8.2 连接 Elasticsearch 7.17 必须用 elasticsearch/elasticsearch:^7.4 客户端，因 v8.x 客户端默认使用 ES 8.x REST API 路径（如 /<index>/_search）、强制 TLS 验证及 Guzzle 7 依赖，与 ES 7.17 不兼容，会导致 404、认证失败或依赖冲突。
PHP 8.2 可以连接 Elasticsearch 7.17，但必须用 elasticsearch/elasticsearch:^7.4 客户端，不能用 ^8.0 —— 否则会因 API 路径、TLS 默认行为和认证方式不兼容直接报错。
为什么不能用 ^8.0 客户端连 ES 7.17
ES 8.x 和 7.x 的 REST API 存在实质性差异：
-
/_search在 7.x 是主路径，在 8.x 被移到/<index>/_search，客户端 v8.x 默认按新路径发请求，7.17 直接返回 404 - ES 7.17 默认仍允许
http.port匿名访问（除非你显式关闭），而 v8.x 客户端默认启用更严格的 TLS 验证和认证前置逻辑 - v8.x 强制依赖 Guzzle 7，但某些 PHP 8.2 环境（尤其旧项目）可能锁死 Guzzle 6，降级装 v7.x 客户端可绕过此冲突
正确安装 elasticsearch/elasticsearch:^7.4
运行以下命令，明确指定兼容版本：
composer require elasticsearch/elasticsearch:^7.4
注意：^7.4 指的是客户端库版本，不是 ES 版本；它对应 ES 7.4–7.17 全系，且已适配 PHP 8.2（含 JIT、协程兼容性修复）。
立即学习“PHP免费学习笔记（深入）”；
如果 composer 报 ext-curl missing 或 json extension not loaded，说明当前 phpenv 切换的 PHP 8.2 缺少必要扩展，需重装：
phpenv install --reinstall 8.2.12
确保编译参数含 --with-curl 和 --enable-json。
连接时认证与 SSL 配置要点
ES 7.17 默认不启用 HTTPS，但若你启用了（比如用 xpack.security.http.ssl），客户端必须同步配置，否则报 cURL error 35 或 SSL certificate problem：
- 开发环境快速跳过验证：
->setSSLVerification(false) - 生产环境必须传证书路径：
->setCABundle('/path/to/http_ca.crt')（该文件由 ESelasticsearch-certutil生成） - 认证方式选其一即可：
->setBasicAuthentication('elastic', 'your_password')或->setApiKey('id', 'api_key')；不要混用 - 主机数组里不要写
user:pass@host这种内联认证——v7.4 客户端不解析 URL 中的 credentials，会静默忽略
验证连接是否真通，别只看代码没报错
很多“连接成功但查不到数据”其实是服务层问题。先手动 curl 验证：
curl -X GET "http://localhost:9200/?pretty" -u elastic:your_password
预期返回含 "version": {"number": "7.17.1"} 的 JSON。如果返回 Connection refused，检查：
- ES 是否真正运行：
systemctl status elasticsearch或ps aux | grep java.*elasticsearch - PHP 所在机器能否访问该地址：
telnet localhost 9200（Linux/macOS）或Test-NetConnection localhost -Port 9200（Windows PowerShell） - Docker 场景下，PHP 容器里写
localhost会连自己，必须改用host.docker.internal（Mac/Win）或宿主真实 IP（Linux）
ES 7.17 的 info() 接口不校验权限，只要网络通、端口开、协议对，就能返回版本号——这是最轻量的连通性探针，比写索引、搜文档更能快速定位是代码问题还是部署问题。
