正确命令是composer require elasticsearch/elasticsearch，官方推荐、支持7.x/8.x及PHP 8.0+；需传hosts数组、body用关联数组、不提供CLI工具、须手动错误处理。
composer install elasticsearch-php 客户端的正确命令
直接运行 composer require elasticsearch/elasticsearch 即可安装官方维护的 PHP 客户端。这个包是 Elasticsearch 官方推荐的，支持 7.x 和 8.x 集群，且已适配 PHP 8.0+。
注意不要用过时的第三方包（比如 ruflin/elastica），它虽仍可用，但不直连原生 REST API，抽象层多、调试困难，也不再同步新版 Elasticsearch 的特性（如 search_after、rank_eval 等）。
- 若项目已锁定 PHP 版本为 8.1+，建议加
--with-all-dependencies避免因依赖冲突导致安装失败 - 如果遇到
ext-curl missing错误，说明 PHP 缺少 cURL 扩展，需先启用（Ubuntu 下执行sudo apt install php-curl，然后重启 Web 服务） - 安装后，
vendor/autoload.php会自动加载客户端类，无需额外注册
初始化 Elasticsearch\Client 的常见写法与避坑点
客户端实例不能只传一个 host 字符串，必须传 hosts 数组（哪怕只有一个节点）。否则会报 Missing argument 1 for Elasticsearch\Client::__construct() 或静默失败。
use Elasticsearch\ClientBuilder;
$client = ClientBuilder::create()
->setHosts(['http://127.0.0.1:9200'])
->setRetries(2)
->build();
-
setHosts()必须是数组，即使单节点也要写成['http://localhost:9200']；协议（http或https）不能省略 - 若 Elasticsearch 启用了 Basic Auth，需在 URL 中嵌入凭证：
'https://user:pass@es.example.com:9200'；不推荐用setAuthentication()，它在 8.x 客户端中已被移除 - 本地开发用 HTTP 就行，生产环境务必用 HTTPS，并确认 PHP 的
openssl.cafile指向有效 CA 证书路径，否则连接会超时或报cURL error 60
执行简单 search 请求时参数结构容易错在哪
Elasticsearch PHP 客户端要求请求体（body）必须是 PHP 关联数组，且键名严格匹配 DSL 规范——比如 query、match、size 全是小写，不能写成 Query 或 SIZE。
$params = [
'index' => 'products',
'body' => [
'query' => [
'match' => [
'title' => 'laptop'
]
],
'size' => 10
]
];
$response = $client->search($params);
-
search()方法不接受 JSON 字符串作为body，传字符串会直接报InvalidParameterException - 如果要查多个索引，
index可以是数组：['products', 'articles']，但不能用逗号拼接字符串 - 返回结果中，命中文档在
$response['hits']['hits']，不是$response['data']或$response->hits（它不是对象）
为什么 vendor/bin/elasticsearch-php 不是可执行命令
这个包没有提供 CLI 工具，vendor/bin/ 下不会生成任何脚本。网上搜到的所谓 elasticsearch-php 命令，基本是误传或混淆了其他工具（比如 elasticsearch-sql 插件或自定义封装脚本）。
真要调试请求，推荐两种方式：
- 用
$client->transport->setLogger()接入 PSR-3 日志器（如 Monolog），能看到完整 HTTP 请求/响应 - 临时改用
curl手动测试：例如curl -XGET "http://127.0.0.1:9200/products/_search?pretty" -H "Content-Type: application/json" -d '{"query":{"match_all":{}}}' - 别指望靠
composer exec或php vendor/elasticsearch/elasticsearch/bin/xxx启动什么服务——它纯 SDK，没内置 server 或 CLI
最常被忽略的是错误处理：客户端默认不抛异常，$response 可能含 error 字段（比如索引不存在），得手动检查 isset($response['error']) 或用 try/catch 包裹并判断 is_array($response) && isset($response['status']) && $response['status'] >= 400。
