Composer 不能直接安装 graphql，因为 Packagist 上无此包；正确命令是 composer require webonyx/graphql-php，它是 PHP 社区标准 GraphQL 服务端库，纯 PHP 实现，无需编译或 php.ini 配置。
Composer 本身不提供 GraphQL 扩展包，它只是 PHP 的依赖管理工具；GraphQL 功能需通过第三方库（如 webonyx/graphql-php）引入，不是 PHP 内置扩展，也不需要编译安装。
为什么不能用 composer install graphql？
执行 composer require graphql 会报错或装错包，因为 graphql 这个包名在 Packagist 上并不存在，也不是官方维护的合法包。真实可用的主流实现是 webonyx/graphql-php —— 它是 PHP 社区事实标准的 GraphQL 服务端库。
-
graphql是一个抽象概念，不是可安装的扩展名 - PHP 没有像
ext-curl那样的原生ext-graphql - 所有 GraphQL 能力都靠纯 PHP 类库实现，无需修改
php.ini或重启 Web 服务
如何正确安装 webonyx/graphql-php
在项目根目录下运行命令即可，不需要全局配置或额外插件：
composer require webonyx/graphql-php
安装后，vendor/ 中会生成 webonyx/graphql-php 目录，自动注册了 PSR-4 自动加载规则。只要项目已引入 vendor/autoload.php，就能直接使用：
$schema = new GraphQL\Type\Schema([ 'query' => new QueryType() ]);
- 支持 PHP 7.4+，推荐搭配
symfony/var-dumper调试 Schema 结构 - 若项目用了 Laravel，可进一步配合
rebing/graphql-laravel简化路由和控制器集成 - 不要手动复制源码或改
composer.json的repositories字段——除非你明确要 fork 并 patch 源码
常见错误：安装后 Class 'GraphQL\\Type\\Schema' not found
这通常不是包没装好，而是自动加载没触发或命名空间写错：
- 确认脚本开头已包含：
require __DIR__ . '/vendor/autoload.php'; - 类名必须带完整命名空间：
GraphQL\Type\Schema，不是GraphQL\Schema或Schema - 运行
composer dump-autoload -o强制重生成优化后的自动加载映射（尤其在 IDE 提示异常但代码能跑时） - 检查是否误用了旧版文档（v14 之前版本类路径不同，如
GraphQL\\Type\\Schema在 v15+ 才稳定）
GraphQL 的关键不在“装对包”，而在定义好 QueryType、MutationType 和解析器逻辑；webonyx/graphql-php 只负责执行和验证，业务逻辑全由你控制——这点比盲目追新包重要得多。
