PHP中动态构建GraphQL查询：变量传参与多值处理实战指南-php教程-PHP中文网

PHP中动态构建GraphQL查询：变量传参与多值处理实战指南

本文详解如何在php中通过graphql变量（variables）安全、灵活地构建动态查询，支持单值/数组参数注入、类型校验及客户端-服务端协同最佳实践。

本文详解如何在php中通过graphql变量（variables）安全、灵活地构建动态查询，支持单值/数组参数注入、类型校验及客户端-服务端协同最佳实践。

在PHP中调用GraphQL API时，硬编码查询条件（如 eq: 2）不仅难以维护，更会带来严重的安全与扩展风险。真正的动态能力源于分离查询结构（query）与运行时数据（variables）——这是GraphQL规范的核心设计原则。下面以电商商品筛选场景为例，完整演示从查询重构、变量注入到HTTP请求封装的全流程。

✅ 正确的动态查询写法：声明式变量 + 类型强约束

首先，将原始静态查询升级为带变量的命名查询（Named Query），并明确声明输入类型：

// ✅ 推荐：使用变量 + 非空数组类型 [Int!]!
$query =  $productIdList];

$jsonPayload = json_encode([
  'query' => $query,
  'variables' => $variables,
  'operationName' => 'MainProducts' // 显式指定操作名，便于服务端日志与缓存
]);

⚠️ 注意：[Int!]! 表示「非空的整数数组」，既允许传入 [2]（单元素），也支持 [2,5,12]（多元素），且服务端Schema可据此做严格校验，避免空数组或null导致的解析失败。

btpanel phpsite 宝塔面板PHP网站
宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

? 完整PHP请求封装（含错误处理）

function executeGraphqlQuery(string $query, array $variables = [], ?string $operationName = null): array
{
    $url = 'https://api.yourshop.com/graphql';
    $jsonPayload = json_encode([
        'query' => $query,
        'variables' => $variables,
        'operationName' => $operationName
    ]);

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $jsonPayload,
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            'Authorization: Bearer ' . $_ENV['GRAPHQL_TOKEN'] ?? ''
        ],
        CURLOPT_TIMEOUT => 30,
        CURLOPT_FAILONERROR => false // 允许捕获4xx/5xx响应体
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($response === false || $httpCode >= 400) {
        throw new RuntimeException("GraphQL request failed (HTTP {$httpCode}): " . curl_error($ch));
    }

    $result = json_decode($response, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new RuntimeException('Invalid JSON response from GraphQL server');
    }

    if (isset($result['errors'])) {
        $errorMessages = array_column($result['errors'], 'message');
        throw new RuntimeException('GraphQL errors: ' . implode('; ', $errorMessages));
    }

    return $result['data'] ?? [];
}

// 使用示例
try {
    $data = executeGraphqlQuery(
        $query,
        ['productTypes' => [2, 5, 12]],
        'MainProducts'
    );
    print_r($data); // 输出匹配的商品列表
} catch (Exception $e) {
    error_log('GraphQL call failed: ' . $e->getMessage());
}

? 关键实践要点总结

永远使用变量，拒绝字符串拼接：避免SQL注入式风险（如 $query = "... eq: {$unsafeInput} ..."），GraphQL变量由解析器自动转义与类型校验；
服务端Schema需同步适配：确保后端GraphQL Schema中 mainProducts 字段的 where 参数支持 productType: { eq: $productTypes } 语法，并正确处理数组匹配逻辑（如 SQL IN 或 MongoDB $in）；
前端调用建议：若使用 Apollo Client 或 Relay，直接传入 variables: { productTypes: [2,5,12] } 即可，无需手动拼接JSON；
调试技巧：在 GraphiQL / Altair 中粘贴带变量的查询，点击右上角「Query Variables」面板输入 JSON 格式变量，实时验证结构合法性。