ThinkPHP 6.x 可用 elasticsearch-php 官方客户端，但需匹配版本：8.x 要求 PHP 8.1+ 且依赖 PSR-18，需 Guzzle；7.17 支持 ThinkPHP 自带 HTTP 客户端；6.x 不兼容 ES 8。
ThinkPHP 6.x 能不能直接用 elasticsearch-php 官方客户端
能，但得看版本。官方 elasticsearch-php 8.x 要求 PHP 8.1+，且默认使用 PSR-18 HTTP 客户端，ThinkPHP 6 默认的 think-http-client 不实现 PSR-18 接口，直接 new Client() 会报 Class "GuzzleHttp\Client" not found 或 no HTTP handler found。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 如果项目已装
guzzlehttp/guzzle（7.5+），可直接 require 官方elasticsearch/elasticsearch:8.x，它会自动适配 Guzzle - 若用 ThinkPHP 自带的 HTTP 客户端，必须降级到
elasticsearch/elasticsearch:7.17（最后支持 PSR-7 的大版本），并手动传入think\facade\Http封装的 handler - 别碰
elasticsearch/elasticsearch:6.x—— 它不兼容 ES 8 的响应结构（比如_type字段已移除），查数据时容易静默丢字段
ES 8.x 集群连不上，提示 SSL certificate problem: unable to get local issuer certificate
这是 cURL 层面的证书校验失败，不是 ThinkPHP 或客户端代码问题。ES 8 默认启用 HTTPS，但本地开发用自签名证书时，PHP cURL 不信任。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 生产环境务必配置合法证书（Let’s Encrypt 或企业 CA），不要关校验
- 开发临时绕过：在创建
Elasticsearch\Client时，通过setHandler注入自定义 Guzzle 实例，并设verify => false - 更安全的开发方案：把 ES 的根证书（
http_ca.crt）导出，存为config/elasticsearch/ca.crt，然后在 client 配置里指定verify => 'config/elasticsearch/ca.crt' - 注意：ThinkPHP 的
Http::setOptions()对 elasticsearch-php 无效，它不走 TP 的 HTTP 抽象层
查询结果里 _source 字段为空，但 Kibana 能看到数据
常见于用了 ES 8 的新索引模板（index template）但没显式开启 _source，或 mapping 中设了 "_source": {"enabled": false}。ThinkPHP 侧发的 DSL 没问题，是服务端存储策略导致的。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先用
curl -XGET 'https://es:9200/your-index/_mapping?pretty'看 mapping，确认_source.enabled是 true - 如果建索引时用了 template，检查 template 中是否漏写
"_source": {"enabled": true}（ES 8 默认 true，但某些迁移脚本会显式关掉） - ThinkPHP 里用
$client->search()时，别依赖返回体里的_source键存在 —— 要先判空：data_get($result, 'hits.hits.0._source', []) - 别在控制器里直接
json($result)返回原始响应，ES 的_shards、took等字段对前端无意义，容易暴露集群信息
高并发下 Connection refused 或请求超时
不是代码写错了，是连接池没配。elasticsearch-php 默认每次请求都新建 TCP 连接，ES 服务端有连接数限制（transport.tcp.port 相关），TP-FPM 子进程一多就打满。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 必须启用连接池：用
elasticsearch/elasticsearch:7.17+或8.x，配置'connectionPool' => \Elasticsearch\ConnectionPool\StaticNoPingConnectionPool::class - 在 TP 的
config/elasticsearch.php里预设 hosts 数组，别只写一个地址 —— 单点故障时 client 不会自动 failover - 别把 client 实例放在闭包或单次请求生命周期里反复 new；应注册为容器 singleton，复用连接
- 如果用 Swoole 或 Hyperf，注意 elasticsearch-php 不是协程安全的，必须配合
Co\Channel或连接池中间件做隔离
ES 和 PHP 客户端之间的边界很薄，很多问题看起来像代码 bug，其实是协议层或部署策略没对齐。尤其是 _source 开关、证书路径、连接复用这三处，线上出问题时 80% 都卡在这儿。
