禁用shell_exec时PHP实现GraphQL POST请求及报错排查

现有基于shell_exec调用系统curl命令请求GraphQL接口的代码，因生产环境禁用shell_exec函数，需要改写为合规的原生PHP cURL代码。涉及两个GraphQL查询需求，自行编写的原生cURL代码请求后返回GraphQL校验错误，需要确认实现方向并修正问题。

原有shell_exec实现代码 #

$curl_string = 'curl -g -X POST -H "Content-Type: application/json" -H "Authorization: Bearer "' . AIRTABLE_API_KEY;
$curl_second_string = ' -d \'{"query": "{fullCapaReview (id: \"' . $id . '\") {proposedRuleName submissionDate agencyContactName statusLawDept}}"}\' https://api.baseql.com/airtable/graphql/appXXXzzzzzzzzzz';
$curl_complete_string = "$curl_string $curl_second_string";
$result = shell_exec($curl_complete_string); 

补充的第二个查询payload：

' -d \'{"query": "{dMsAgencies (agencyAcronym: \"' . $_agency . '\") {agencyAcronym fullCapaReview { id }}}"\'

自行编写的尝试代码 #

$curl = curl_init($url);
$query = 'query dMsAgencies($agencyAcronym: String) {agencyAcronym fullCapaReview { id }} ';
$variables = ["agencyAcronym" => $id ];
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode(['query' => $query, 'variables' => $variables])); 
curl_setopt($curl, CURLOPT_HTTPHEADER, ['Content-Type: application/json','Authorization: Bearer ' . AIRTABLE_API_KEY]);
$response = curl_exec($curl);
curl_close($curl);

console_log("Response : " . $response);

返回核心报错 #

• 错误1：Cannot query field "agencyAcronym" on type "Query"，翻译：无法在Query根类型上查询agencyAcronym字段
• 错误2：Variable "$agencyAcronym" is never used in operation "dMsAgencies"，翻译：变量$agencyAcronym在dMsAgencies查询操作中从未被使用

PHP cURL实现方向完全正确，报错和cURL本身无关，是几个细节问题导致的：

1. GraphQL查询结构写错：把属于dMsAgencies返回结果的agencyAcronym字段直接写在了根Query层级，根Query不存在这个字段，触发第一个错误
2. 参数绑定错误：定义了查询接收$agencyAcronym变量，但没有把这个变量传给根字段dMsAgencies，导致变量声明后未使用，触发第二个错误
3. 代码缺失两个关键cURL配置：未设置CURLOPT_RETURNTRANSFER会导致响应内容直接输出而非作为返回值存入$response；未显式设置CURLOPT_POST可能受环境默认配置影响请求方式
4. 变量映射错误：第二个查询的agencyAcronym参数对应值应为$_agency，误传了第一个查询用的$id

通用cURL配置说明 #

所有GraphQL请求都需要配置以下基础项：

• 显式指定POST请求方法
• 开启CURLOPT_RETURNTRANSFER获取响应字符串
• 请求头设置正确的Content-Type和Authorization
• POST内容为JSON格式的query和variables结构
• 增加cURL层面的错误捕获，方便排查网络类问题

第一个查询（fullCapaReview）实现 #

// 接口地址
$apiUrl = 'https://api.baseql.com/airtable/graphql/appXXXzzzzzzzzzz';
// GraphQL查询语句，用nowdoc语法避免转义问题
$query = <<<'GRAPHQL'
query GetFullCapaReview($id: String!) {
  fullCapaReview(id: $id) {
    proposedRuleName
    submissionDate
    agencyContactName
    statusLawDept
  }
}
GRAPHQL;
// 绑定变量
$variables = [
    'id' => $id
];
// 初始化请求
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'query' => $query,
    'variables' => $variables
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . AIRTABLE_API_KEY
]);
// 执行请求
$response = curl_exec($ch);
$curlErr = curl_error($ch);
curl_close($ch);
// 处理cURL层错误
if ($curlErr) {
    throw new Exception("接口请求失败：" . $curlErr);
}
// 解析响应结果为数组
$result = json_decode($response, true);

第二个查询（dMsAgencies）实现 #

// 接口地址
$apiUrl = 'https://api.baseql.com/airtable/graphql/appXXXzzzzzzzzzz';
// 修正后的查询语句：参数绑定到dMsAgencies字段，返回字段嵌套在dMsAgencies块内
$query = <<<'GRAPHQL'
query GetDmsAgencies($agencyAcronym: String) {
  dMsAgencies(agencyAcronym: $agencyAcronym) {
    agencyAcronym
    fullCapaReview {
      id
    }
  }
}
GRAPHQL;
// 修正变量映射，对应传入$_agency
$variables = [
    'agencyAcronym' => $_agency
];
// 初始化请求
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'query' => $query,
    'variables' => $variables
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . AIRTABLE_API_KEY
]);
// 执行请求
$response = curl_exec($ch);
$curlErr = curl_error($ch);
curl_close($ch);
// 处理cURL层错误
if ($curlErr) {
    throw new Exception("接口请求失败：" . $curlErr);
}
// 解析响应结果为数组
$result = json_decode($response, true);

• 用PHP nowdoc语法定义GraphQL查询语句可以避免大量引号转义问题，减少语法错误
• 不推荐直接把变量拼接进查询字符串，用variables传参可以自动处理转义，也避免注入风险
• 拿到响应后优先判断$result['errors']是否存在，处理GraphQL层面返回的业务错误

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