Composer安装webonyx/graphql-php后报GraphQL\Client类未找到错误

核心问题 #

你遇到的错误根源很明确：webonyx/graphql-php库本身并不包含GraphQL\Client和GraphQL\Query这两个类。这个库的定位是GraphQL规范的PHP实现，主要用于在服务端定义GraphQL Schema、解析并执行查询，而非提供发起HTTP GraphQL请求的客户端功能。

验证依据 #

你发现库目录里没有src/client.php是正确的，查看该库源码结构，确实不存在这类HTTP客户端相关的类文件。

解决方案 #

根据你的实际需求，分两种场景处理：

场景1：需要发起HTTP请求调用远程GraphQL接口

你需要使用专门的HTTP客户端来实现，可选择手动构建请求或使用封装好的GraphQL客户端库：

• 手动用Guzzle实现的示例：

<?php
require_once 'vendor/autoload.php';

use GuzzleHttp\Client;

$graphqlEndpoint = 'https://platformurl';
$client = new Client();

// 构建GraphQL查询语句
$query = <<<'GRAPHQL'
query {
  # 替换为你实际要执行的查询内容
  exampleField {
    id
    name
  }
}
GRAPHQL;

try {
    $response = $client->post($graphqlEndpoint, [
        'json' => [
            'query' => $query,
            // 如需传递变量，添加 'variables' => []
        ],
        // 如需API密钥，添加请求头
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
            'Content-Type' => 'application/json',
        ]
    ]);

    $data = json_decode($response->getBody(), true);
    print_r($data);
} catch (Exception $e) {
    echo '请求失败: ' . $e->getMessage();
}

• 或者使用封装好的GraphQL客户端库（比如mll-lab/graphql-php-client），执行composer require mll-lab/graphql-php-client安装后，按照其文档使用即可。

场景2：想搭建自己的GraphQL服务端

如果是想用webonyx/graphql-php构建服务端，正确的基础示例如下：

<?php
require_once 'vendor/autoload.php';

use GraphQL\Type\Definition\ObjectType;
use GraphQL\Type\Definition\Type;
use GraphQL\GraphQL;

// 定义简单的Query类型
$queryType = new ObjectType([
    'name' => 'Query',
    'fields' => [
        'hello' => [
            'type' => Type::string(),
            'resolve' => fn() => 'Hello World',
        ],
    ],
]);

// 定义Schema
$schema = new \GraphQL\Type\Schema([
    'query' => $queryType,
]);

// 执行查询
$rawQuery = '{ hello }';
$result = GraphQL::executeQuery($schema, $rawQuery);
$output = $result->toArray();

print_r($output);

额外说明 #

你执行的composer install/update操作本身没有问题，PHP8+版本也完全兼容webonyx/graphql-php 15.x版本，问题完全出在对库的功能定位误解上。

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