PHP实现GraphQL API的cURL认证请求问题求助

问题根源分析 #

你的代码存在几个关键错误，直接导致请求失败：

• POST数据格式不匹配：原cURL发送的是JSON格式数据，但PHP中直接传数组给CURLOPT_POSTFIELDS时，curl会自动将其编码为表单格式（application/x-www-form-urlencoded），和API要求的application/json格式冲突。
• 缺少Content-Type请求头：没有设置Content-Type: application/json，API无法正确解析你的请求内容。
• 多余的Basic Auth配置：原cURL命令未使用Basic认证，你代码中添加的CURLOPT_HTTPAUTH, CURLAUTH_BASIC会干扰正常请求流程。

解决方案分步说明 #

1. 修正POST数据格式与请求头 #

必须将查询数组转换为JSON字符串，并设置对应的请求头：

// 设置JSON请求头
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
// 将数组转为JSON字符串
$postData = json_encode($auth_data);
curl_setopt($curl, CURLOPT_POSTFIELDS, $postData);

2. 简化GraphQL查询的换行处理 #

GraphQL查询对换行没有强制要求，你可以选择两种方式处理：

• 单行查询：简洁直观，适合简单查询

  $query = 'mutation { signIn(apiKey: "API_KEY", password: "ACCOUNT_PASSWORD") { token } }';
  

• Heredoc语法：适合复杂查询，可读性高，无需手动转义引号和换行

  $query = <<<'GRAPHQL'
  mutation {
    signIn(apiKey: "API_KEY", password: "ACCOUNT_PASSWORD") {
      token
    }
  }
  GRAPHQL;
  

3. 密码以$开头的转义问题 #

你的处理方式是正确的：在双引号字符串中，用\$转义可以避免PHP将$开头的内容解析为变量。更简便的方式是用单引号包裹密码部分，单引号字符串不会解析变量，直接写'password: "$REST_OF_PASSWORD"'即可。

修正后的完整代码 #

<?php
$curl = curl_init();

// 用Heredoc编写GraphQL查询，避免转义麻烦
$query = <<<'GRAPHQL'
mutation {
  signIn(apiKey: "你的API_KEY", password: "$你的密码") {
    token
  }
}
GRAPHQL;

$auth_data = array(
    "query" => $query
);

// 转换为JSON字符串
$postData = json_encode($auth_data);

curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $postData);
curl_setopt($curl, CURLOPT_URL, 'https://a.n.domain/graphql');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
// 设置JSON请求头
curl_setopt($curl, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json'
));

$result = curl_exec($curl);

// 添加错误排查，方便调试
if(curl_errno($curl)){
    die('CURL错误：' . curl_error($curl));
}

if(!$result){
    die("请求失败");
}

curl_close($curl);
echo $result;
?>

额外调试建议 #

如果请求仍失败，通过curl_error($curl)可以查看具体错误原因（比如DNS解析失败、SSL证书问题）。若为SSL证书问题，可临时添加curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);（生产环境不建议，推荐配置合法证书）。

内容的提问来源于stack exchange，提问作者Phaethon