elasticsearch/elasticsearch v8.x 是唯一兼容 elasticsearch 8.0 的 php 客户端，php 7.3 可连接但需满足前提：使用 ^8.0 客户端、guzzle 7.x、https 协议、ca 证书及 api key 或 basic auth 认证，并注意运行时配置与错误排查。
elasticsearch/elasticsearch 客户端 v8.x 是唯一兼容 Elasticsearch 8.0 的 PHP 客户端，PHP 7.3 可以连接 ES 8.0，但必须满足几个硬性前提——否则会直接报错或静默失败。
确认客户端版本与 PHP 7.3 兼容性
elasticsearch/elasticsearch:^8.0 明确支持 PHP ^7.3 || ^8.0（官方 composer.json 声明），但要注意：
- 不要用
^7.0或^7.4版本去连 ES 8.0：API 路径变更（如/_search→/_search保留但认证/SSL/错误码逻辑已重构）、TLS 默认启用、Basic Auth 被弃用（推荐 API Key） - Guzzle 7 是强制依赖：PHP 7.3 必须能加载 Guzzle 7.x（
guzzlehttp/guzzle:^7.0），若项目锁死 Guzzle 6，composer install会失败，不能绕过
执行以下命令安装正确版本：
composer require elasticsearch/elasticsearch:^8.0
安装后检查：composer show elasticsearch/elasticsearch 应输出类似 v8.4.0；composer show guzzlehttp/guzzle 应为 7.x 系列。
ES 8.0 默认启用安全通信，PHP 必须配 TLS 和认证
Elasticsearch 8.0 开箱即用启用 HTTPS + 基于证书的 TLS + 内置用户认证。用 http:// 协议直连会返回 cURL error 60: SSL certificate problem 或 401。
正确做法是：
- 获取 ES 启动时生成的 CA 证书（通常在
$ES_HOME/config/certs/http_ca.crt） - 使用
elastic用户密码（首次启动时终端会打印）或更安全的API Key - host 必须写
https://，不能省略协议
示例连接代码：
$client = ClientBuilder::create()
->setHosts(['https://127.0.0.1:9200'])
->setBasicAuthentication('elastic', 'your_actual_password')
->setCABundle('/path/to/http_ca.crt')
->build();
若用 Elastic Cloud，改用：
$client = ClientBuilder::create()
->setElasticCloudId('YOUR_CLOUD_ID')
->setApiKey('YOUR_API_KEY_BASE64_ENCODED')
->build();
注意：setBasicAuthentication() 在 v8 客户端中仍可用，但 ES 8.0 官方文档已标记为 legacy；生产环境优先用 setApiKey()。
常见连接失败原因与对应修复
遇到连接不上，先看错误类型再对症：
401 Unauthorized：host 字符串里没带认证，或密码错误；setBasicAuthentication() 参数顺序不能颠倒（用户名在前，密码在后）
cURL error 60 / 77 / 35：证书路径错、文件不可读、或 CA bundle 没生效；确认 /path/to/http_ca.crt 是绝对路径且 PHP 进程有读权限
Connection refused / timeout：ES 没监听 0.0.0.0:9200（检查 elasticsearch.yml 中 network.host 和 http.port）；或防火墙拦截（CentOS 用 firewall-cmd --list-ports 查）
Client error: `GET https://127.0.0.1:9200/` resulted in a `404 Not Found` response：客户端版本太低（比如误装了 v7.x），或 ES 实际运行的是 7.x 却用了 v8 客户端（反向不兼容）
PHP 7.3 下需额外留意的运行时细节
ES 8.x 客户端大量使用 PHP 7.3+ 的新语法（如 nullable 类型、arrow 函数），但不会触发 fatal error —— 前提是你没开严格模式或没手动调用有问题的内部方法。
真正容易被忽略的点：
-
max_execution_time：批量导入时默认 30 秒可能不够，建议脚本开头加set_time_limit(0) -
memory_limit：搜索返回大量 hits 时易 OOM，尤其用scroll或search_after，建议设为512M起 - SSL 验证绕过（仅开发）：不要用
->setSSLVerification(false)，v8 客户端已移除该方法；必须用有效 CA bundle
验证连通最简方式：
var_dump($client->info()); // 应返回包含 version.number 的数组，如 "8.12.2"
如果 info() 成功但后续操作失败，问题大概率出在索引 mapping 或查询 DSL 语法上，而不是连接本身。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
