如何在PHP中动态构建GraphQL查询？

我需要在PHP里动态构建GraphQL查询，比如目标查询是这样的：

$q = "
{ 
    shop { 
        name 
    } 
}
";

最初我尝试用数组来动态构建：

$fieldName = 'name';

$query = [
    "shop" => [
        $fieldName
    ]
];

但把这个数组转成GraphQL兼容格式时，自己写的递归函数效率不高，用json_encode()也得不到正确的语法格式。而且实际场景里的查询会包含变量、参数和别名，需要更通用的解决方案。

下面是几种靠谱的解决思路：

1. 用成熟的GraphQL PHP库（最推荐） #

直接用专门的库来处理，比如webonyx/graphql-php，它能完美支持字段、参数、变量、别名等所有GraphQL语法元素，不用自己造轮子，稳定性和效率都有保障。

示例代码：

use GraphQL\Language\AST\DocumentNode;
use GraphQL\Language\AST\FieldNode;
use GraphQL\Language\AST\NameNode;
use GraphQL\Language\AST\OperationDefinitionNode;
use GraphQL\Language\Printer;

// 构建AST节点
$shopField = new FieldNode([
    'name' => new NameNode(['value' => 'shop']),
    'selectionSet' => [
        'selections' => [
            new FieldNode(['name' => new NameNode(['value' => 'name'])])
        ]
    ]
]);

$operation = new OperationDefinitionNode([
    'operation' => 'query',
    'selectionSet' => ['selections' => [$shopField]]
]);

$document = new DocumentNode(['definitions' => [$operation]]);

// 打印成标准GraphQL查询字符串
$graphqlQuery = Printer::doPrint($document);

这种方式完全适配复杂场景，不管是变量传递、参数拼接还是别名设置都能轻松处理。

2. 优化递归函数（不想用第三方库时） #

如果不想引入外部依赖，可以优化自己的递归函数，让它支持参数、变量和别名的处理，同时提升实用性。先调整数组结构，让每个字段可以携带额外信息：

优化后的数组结构示例：

$query = [
    'shop' => [
        // 带别名的字段
        ['alias' => 'shopName', 'field' => 'name'],
        // 带参数的嵌套字段
        ['field' => 'product', 'args' => ['id' => 123], 'selections' => ['title', 'price']]
    ]
];

对应的递归函数：

function buildGraphQLQuery($queryArray, $indent = 0) {
    $indentStr = str_repeat('    ', $indent);
    $output = '';

    foreach ($queryArray as $key => $value) {
        if (is_array($value)) {
            // 处理带别名、参数、子选择的字段
            if (isset($value['field'])) {
                $fieldStr = '';
                // 拼接别名
                if (isset($value['alias'])) {
                    $fieldStr .= $value['alias'] . ': ';
                }
                $fieldStr .= $value['field'];
                // 拼接参数
                if (isset($value['args']) && !empty($value['args'])) {
                    $argsStr = [];
                    foreach ($value['args'] as $argKey => $argVal) {
                        $argValStr = is_string($argVal) ? "\"{$argVal}\"" : $argVal;
                        $argsStr[] = "{$argKey}: {$argValStr}";
                    }
                    $fieldStr .= '(' . implode(', ', $argsStr) . ')';
                }
                // 处理子选择
                if (isset($value['selections']) && !empty($value['selections'])) {
                    $output .= "{$indentStr}{$fieldStr} {\n";
                    $output .= buildGraphQLQuery($value['selections'], $indent + 1);
                    $output .= "{$indentStr}}\n";
                } else {
                    $output .= "{$indentStr}{$fieldStr}\n";
                }
            } else {
                // 普通嵌套字段
                $output .= "{$indentStr}{$key} {\n";
                $output .= buildGraphQLQuery($value, $indent + 1);
                $output .= "{$indentStr}}\n";
            }
        } else {
            // 普通字段
            $output .= "{$indentStr}{$value}\n";
        }
    }

    return $output;
}

// 包裹外层查询大括号
$finalQuery = "{\n" . buildGraphQLQuery($query) . "}";

这个优化后的函数能覆盖大部分复杂场景，而且递归的效率对于常规GraphQL查询来说完全够用，除非是极端复杂的嵌套结构，这种情况还是推荐用专业库。

3. 模板字符串拼接（适合简单场景） #

如果你的查询结构不算特别复杂，也可以用PHP的HEREDOC或者字符串拼接来动态构建，这种方式直观高效：

$fieldName = 'name';
$shopId = 456;

$query = <<<GRAPHQL
{
    shop(id: {$shopId}) {
        {$fieldName}
        products {
            title
            price
        }
    }
}
GRAPHQL;

但这种方式在处理大量动态字段、变量或者复杂嵌套时，维护成本会很高，容易出错，只适合简单场景。

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