Composer怎么安装Laravel Lighthouse GraphQL_Composer如何引入Lighthouse在Laravel中搭建GraphQL API【教程】-composer-PHP中文网

lighthouse 命令需通过 php artisan lighthouse:install 启用，非全局命令；schema.graphql 必须置于 graphql/schema.graphql（base_path 下），仅支持 .graphql 后缀；graphql 接口默认禁用 get 请求，405 错误属正常安全限制；@auth 指令依赖 guard 配置，需匹配 api 场景的 api guard。

composer怎么安装laravel lighthouse graphql_composer如何引入lighthouse在laravel中搭建graphql api【教程】

composer require 之后 `lighthouse` 命令不识别？

因为 Lighthouse 不是全局命令，它只注册为 Laravel 的 Artisan 命令。安装后必须通过 php artisan lighthouse:install 才能启用核心配置和命令支持。

常见错误现象：Command "lighthouse:install" is not defined —— 这通常是因为 Composer 安装成功但未执行该 Artisan 命令，或服务提供者未自动注册（Laravel 5.5+ 一般自动发现，但低于此版本需手动在 config/app.php 中添加 Nuwave\Lighthouse\Providers\LighthouseServiceProvider::class）。

确认 Laravel 版本 ≥ 8.0（Lighthouse v6+ 要求），旧版需降级使用 v5
运行 php artisan vendor:publish --provider="Nuwave\Lighthouse\Providers\LighthouseServiceProvider" 手动发布配置（尤其 Laravel 9+ 可能跳过自动发布）
检查 app/Providers/AppServiceProvider.php 中是否误删了 public function boot() 或干扰了服务绑定

schema.graphql 文件放哪、怎么加载？

Lighthouse 默认从 graphql/schema.graphql 读取 Schema，路径是相对 base_path() 的，不是 resources/ 下。放错位置会导致 Schema must be provided 错误或空响应。

使用场景：开发时你写类型、查询、Mutation；部署时 Lighthouse 会编译成 PHP 类缓存，所以文件必须可读且路径固定。

确保该文件存在且至少含一行 type Query { ping: String! }
若想换路径（比如放在 resources/graphql/），需在 config/lighthouse.php 中修改 'schema' => base_path('resources/graphql/schema.graphql')
别用 .gql 后缀——Lighthouse 只认 .graphql，否则解析失败无提示

GraphQL 查询返回 405 Method Not Allowed？

默认 Lighthouse 只允许 POST 请求访问 /graphql，浏览器直接 GET 访问会触发 405。这不是配置错误，而是安全限制。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

性能 / 兼容性影响：开启 GET 会暴露 schema（如带 ?query={__schema{types{name}}}），线上环境务必关闭。

开发调试时可用 curl -X POST http://localhost/graphql -H "Content-Type: application/json" -d '{"query":"{ping}"}'
若真要支持 GET（例如某些前端工具链需要），在 routes/graphql.php 中显式添加 Route::get('/graphql', [\Nuwave\Lighthouse\Support\Http\Controllers\GraphQLController::class, 'query']);
注意：Laravel 的 CSRF 保护对 GraphQL POST 默认关闭，但若你在中间件中强制校验，会导致 419，需排除 /graphql 路由

启用 `@auth` 指令却报 `Unauthorized`？

@auth 依赖 Laravel 的守卫（guard）机制，但它默认用 web guard，而 API 场景常用 api。没配对就会静默拒绝。

参数差异：指令本身不传 guard 名，靠上下文——Lighthouse 从请求头 Authorization: Bearer xxx 推断，再调用 Auth::guard('api')->user()。

确认 config/auth.php 中 'defaults.guard' 是 'api'，或在 config/lighthouse.php 的 'guards' 配置项里显式指定 ['api']
如果用 Sanctum，确保请求头带 Accept: application/json，否则 Laravel 可能 fallback 到 web guard
测试时别用 tinker 或 PHPUnit 直接调用 resolver——@auth 依赖完整的 HTTP 请求生命周期，单元测试需用 actingAs($user, 'api')