推荐使用官方客户端 elasticsearch/elasticsearch，需通过 composer require elasticsearch/elasticsearch:^8.0 安装，ES 8.x 必须匹配 v8.x 客户端，依赖 Guzzle 7+，默认启用 TLS 和 API key 认证，info() 方法可快速验证连通性。
PHP 连 Elasticsearch 用什么客户端？
官方早已弃用 elasticsearch-php 的 legacy 版本（v2.x 及更早），现在唯一推荐的是官方维护的 elasticsearch/elasticsearch 包，基于 PSR-7 和 Guzzle 7+，支持 PHP 7.4+ 和 ES 7.x / 8.x。
别再找“elasticsearch_php”或“elasticsearch-php”带下划线的旧包——那不是官方库，也不是 Composer 正确包名。
怎么装 elasticsearch/elasticsearch 客户端？
运行以下命令安装最新稳定版（以 ES 8.x 为目标）：
composer require elasticsearch/elasticsearch:^8.0
注意：^8.0 会拉取兼容 Elasticsearch 8.x 的客户端；若你用的是 ES 7.17，请改用 ^7.4（对应客户端 v7.4+，非 v7.0）。
立即学习“PHP免费学习笔记（深入）”；
PHP5学习对象教程由美国人古曼兹、贝肯、瑞桑斯编著，简张桂翻译，电子工业出版社于2007年12月1日出版的关于PHP5应用程序的技术类图书。该书全面介绍了PHP 5中的新功能、编程方法及设计模式，还分析阐述了PHP 5中新的数据库连接处理、错误处理和XML处理等机制，帮助读者系统了解、熟练掌握和高效应用PHP。
- ES 8.x 必须用客户端 v8.x，否则会因 TLS、API 路径、认证方式（如 API key 替代 basic auth）报错
- Guzzle 7 是硬依赖，如果你项目锁死了 Guzzle 6，得先升级或隔离环境
- 不支持 HHVM，也不支持 PHP
连不上 ES？检查这三件事
常见报错如 cURL error 7: Failed to connect、Connection refused 或 SSL certificate problem，往往不是代码问题，而是配置没对：
-
host写成localhost却在 Docker 中跑 PHP —— 改用host.docker.internal（Mac/Win）或宿主 IP（Linux） - ES 启用了 HTTPS 但客户端没配
ssl.certificate_authority或设ssl.verify_peer => false（仅开发） - ES 8.x 默认关闭
http.port的匿名访问，必须传api_key或basic_auth，例如：$client = ClientBuilder::create() ->setHosts(['https://localhost:9200']) ->setBasicAuthentication('elastic', 'your_password') ->build();
简单查一条数据，代码长啥样？
别一上来就写复杂 DSL，先验证连接通不通：
$client = ClientBuilder::create()
->setHosts(['http://localhost:9200'])
->build();
try {
$response = $client->info();
echo $response['version']['number']; // 输出类似 "8.12.2"
} catch (Exception $e) {
echo 'Error: ' . $e->getMessage();
}
这个 info() 是最轻量的 API，不走索引、不鉴权（除非你关了匿名访问），适合快速确认网络、协议、版本是否匹配。很多“连不上”的问题，卡在连通性验证之前就放弃了。
ES 8.x 的响应结构、错误格式、默认序列化方式都和 7.x 不同，哪怕只是换了个小版本号，也建议在 composer.json 中锁死客户端版本，而不是用 ^8.0 模糊匹配。
