Yii2无官方GraphQL扩展，应直接集成webonyx/graphql-php：装库、写Schema类、在控制器中解析请求并执行查询，resolver需通过$context访问Yii组件。
Yii2里没有官方GraphQL扩展，别找yii2-graphql这个包
市面上并不存在一个叫 yii2-graphql 的、由Yii团队维护或广泛认可的“标准扩展”。你搜到的所谓教程，大概率是个人封装的非主流包，版本陈旧、文档缺失、不兼容新版 Yii2 或 webonyx/graphql-php。强行安装容易卡在依赖冲突（比如要求 php: ^7.1，而你用的是 PHP 8.2）或者执行时报 Class 'GraphQL\Type\Schema' not found——因为底层库升级后命名空间或构造方式变了。
正确路径只有一条：绕过“扩展幻觉”，直接集成行业事实标准库 webonyx/graphql-php，自己搭端点。它轻量、稳定、文档全，且和 Yii2 的生命周期天然兼容。
怎么手动接入webonyx/graphql-php（最小可行步骤）
核心就三件事：装库、写 Schema、挂控制器。不需要改框架内核，也不用动 autoloader。
- 运行
composer require webonyx/graphql-php（推荐加--with-all-dependencies避免提示 missing ext-json） - 新建一个控制器动作，比如
SiteController::actionGraphql()，里面只做三件事：
– 读取php://input解析 JSON；
– 调用GraphQL::executeQuery()；
– 返回 JSON 响应（注意设Content-Type: application/json） - Schema 定义建议单独抽成类（如
app\graphql\SchemaFactory），用GraphQL\Type\Schema构建，别硬塞在控制器里——否则改个字段就得重载整个 action
示例关键行：$result = GraphQL::executeQuery($schema, $query, $rootValue, $context, $variables, $operationName);
这里 $rootValue 通常传 null，$context 可传 Yii::$app 方便 resolver 里访问用户、DB 等。
resolver里怎么安全访问Yii的组件和服务？
GraphQL 的 resolver 是纯函数，不自动继承控制器上下文。常见错误是直接在 resolver 里写 Yii::$app->user->id 却没传 $context，结果报 Trying to get property 'user' of non-object。
- 必须在
executeQuery()调用时显式传入$context = Yii::$app - resolver 函数签名得带
$context参数：function ($root, $args, $context, $info) { return $context->user->identity; } - 别在 resolver 里 new Model 或调 DB 查询——用
$context->db或封装好的 service 层，保持可测性
顺带一提：$root 在顶层 query 字段里通常是 null，别指望它带数据；真正要传初始数据，走 $rootValue 参数更清晰。
调试时返回空响应或500，先查这三处
GraphQL 不像 REST 那样有明确的 HTTP 状态码映射，出错经常静默返回空 JSON 或 500，但日志里没线索。高频原因：
-
display_errors = Off且没开 Yii 的logtarget → 在index.php顶部临时加ini_set('display_errors', '1'); - Schema 构建时报错（比如 type 名重复、field 返回类型未定义）→ 把
SchemaFactory的构建逻辑包在 try/catch 里，echo $e->getMessage()直接看 - POST 请求体不是标准 GraphQL JSON 格式（漏了
query字段，或variables是字符串而非对象）→ 用file_get_contents('php://input')打印原始输入，确认结构
真正麻烦的不是集成，是 schema 设计初期没想清楚字段粒度——比如把一个商品详情所有字段全扔进一个 product query 里，后期加权限、缓存、监控就全卡住。这事没法靠工具解决，得人盯。
