Docker环境下PHP连接Couchbase报LCB_EINVAL错误求助

从你的描述来看，核心问题出在Docker容器间的网络连通性和连接参数的错误使用上，下面一步步拆解解决：

1. 最关键的错误：用127.0.0.1访问跨容器的Couchbase #

每个Docker容器都有独立的网络栈，PHP容器里的127.0.0.1指向的是它自己，而不是Couchbase容器。你需要替换成Couchbase容器的内网IP或者容器名称（前提是两个容器在同一个Docker网络下）。

怎么获取正确的连接地址？ #

• 方法一：查看Couchbase容器的内网IP：
  执行docker inspect <你的Couchbase容器ID/名称>，在输出的NetworkSettings -> IPAddress字段找到内网IP，比如172.17.0.2。
• 方法二：给Couchbase容器指定固定名称，直接用名称访问：
  启动Couchbase容器时加上--name couchbase-cluster参数，之后PHP代码里直接用couchbase-cluster:8091作为连接地址。

2. 认证方式的规范使用（针对SDK 2.6.x） #

你的SDK版本是2.6.1，注意authenticateAs的参数顺序和使用场景：

• 如果是用集群管理员账号（Administrator）认证，应该在打开Bucket前调用：

  $cluster->authenticateAs('Administrator', '123456');
  

• 如果是直接用Bucket的凭证（default/123456），可以简化为在openBucket时直接传入密码：

  $myBucket = $cluster->openBucket('default', '123456');
  

3. 修正后的完整测试代码 #

// 替换成你的Couchbase容器名称/内网IP
$cluster = new CouchbaseCluster("couchbase-cluster:8091?detailed_errcodes=1");
// 用集群管理员账号认证
$cluster->authenticateAs('Administrator', '123456');
// 打开指定Bucket
$myBucket = $cluster->openBucket('default');

// 或者直接用Bucket凭证打开
// $myBucket = $cluster->openBucket('default', '123456');

额外排查步骤 #

• 确认容器在同一网络：如果两个容器不在同一个Docker网络，PHP容器无法访问Couchbase容器。可以创建自定义网络并把两个容器加入：

  # 创建自定义网络
  docker network create couchbase-network
  # 重启Couchbase容器加入网络
  docker run -d --name couchbase-cluster --network couchbase-network -p 8091:8091 -p 11210:11210 couchbase
  # 重启PHP容器加入同一网络
  docker run -d --name php-app --network couchbase-network ... 你的PHP容器启动参数
  

• 验证端口连通性：在PHP容器内部执行telnet couchbase-cluster 8091或nc -zv couchbase-cluster 8091，确认8091（管理端口）和11210（KV端口）能正常访问。
• 检查Couchbase状态：访问Couchbase的Web管理界面（宿主机IP:8091），确认集群正常运行、Bucket "default"存在且凭证正确。

内容的提问来源于stack exchange，提问作者mohammad fallah.rasoulnejad