使用Elastica通过HTTP(S)连接Elasticsearch时抛出错误

看起来你在本地用Docker搭了Elasticsearch 8.1.0节点，搭配PHP服务用Elastica连接时遇到报错了对吧？我帮你捋几个实战中最常见的问题和解决办法，都是踩过坑总结出来的：

• Elasticsearch 8.x的安全配置默认开启，这是头号坑
  8.x版本默认强制开启HTTPS和身份验证，你得先确认这几点：

  1. 你的ES容器环境变量里有没有设置ELASTIC_PASSWORD？不管是.env还是.elastic.env里，这个密码是elastic用户的登录凭证，必须和Elastica连接时的配置对应。
  2. Elastica连接代码里要明确指定HTTPS协议、用户名密码，甚至证书验证（本地开发可以先跳过），示例代码如下：

     $clientConfig = [
         'host' => 'elasticsearch', // 要是PHP和ES都是docker-compose启动的，直接用服务名当host就行
         'port' => 9200,
         'username' => 'elastic',
         'password' => '你的ELASTIC_PASSWORD值',
         'scheme' => 'https', // 8.x默认开HTTPS，必须指定
         'verify' => false, // 本地测试可以关证书验证，生产环境一定要配可信证书
     ];
     $client = new \Elastica\Client($clientConfig);
     

  要是你只是本地测试不想折腾HTTPS，可以在ES的环境变量里加xpack.security.enabled=false和xpack.security.http.ssl.enabled=false，重启容器后用HTTP协议连接（scheme设为http）。

• Docker网络的小细节别忽略

  • 如果你的PHP服务是Docker容器，那必须和ES容器在同一个网络里（docker-compose启动的话默认会创建专属网络，直接用服务名elasticsearch当host就行，别用localhost，容器里的localhost指的是自己，不是宿主机）。
  • 要是PHP是在宿主机跑的，那可以用localhost:9200当连接地址，但要先确认宿主机能访问到ES的9200端口，比如用curl -u elastic:你的密码 -k https://localhost:9200测试，能拿到ES的JSON响应才算通。

• 证书验证问题（生产环境必看）
  8.x默认生成自签名证书，Elastica默认会验证证书有效性，本地开发可以暂时关verify，但生产环境一定要把ES的CA证书（容器路径是/usr/share/elasticsearch/config/certs/http_ca.crt）复制到PHP服务能访问的路径，然后在Elastica配置里指定证书路径：

  'verify' => '/path/to/http_ca.crt', // 替换成你的实际证书路径
  

• 先测通基础连接再用Elastica
  建议先不用Elastica，用curl命令测试ES的连通性：

  # 宿主机测试
  curl -u elastic:你的ES密码 -k https://localhost:9200
  # PHP容器内部测试（如果PHP在容器里）
  docker exec -it 你的PHP容器名 curl -u elastic:你的ES密码 -k https://elasticsearch:9200
  

  如果curl能返回包含name、cluster_name的JSON响应，说明ES本身没问题，再排查Elastica的配置细节。

备注：内容来源于stack exchange，提问作者Bertuz