Laravel8怎样用cURL发送GraphQL-php教程-PHP中文网

laravel 8 中不推荐直接用原生 curl 发送 graphql 请求，因其需手动处理 json 编码、content-type 设置、变量类型匹配及错误解析，易出错且无法复用框架的异常处理、日志和测试能力；推荐使用 laravel http facade 或 guzzle。

laravel8怎样用curl发送graphql

Laravel 8 中不推荐直接用原生 cURL 发送 GraphQL 请求，原因很实际：GraphQL 请求需严格遵循 JSON 格式、正确设置 Content-Type: application/json、手动编码查询字符串（含变量）、处理响应解析与错误判别——这些环节用 cURL 容易出错，且无法复用 Laravel 的异常处理、日志、测试 Mock 等能力。

但如果你因特殊场景（如极简脚本、调试临时调用、或集成遗留模块）必须使用 cURL，以下是安全、可运行的写法要点：

✅ 正确构造 GraphQL POST 请求（cURL 方式）

GraphQL 请求本质是带 query 字段的 JSON POST，可选携带 variables。关键不是“怎么发”，而是怎么发得准、收得稳。

Leaf Curling & Margin Scorch Diagnosis | 植物卷叶/焦边识别（干旱/病害）

利用农业相机拍摄植物叶片高分辨率图像，通过AI视觉技术检测叶片卷曲方向（向上卷曲或向下卷曲）

下载

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => 'http://localhost/graphql',
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode([
        'query'     => 'query GetUser($id: ID!) { user(id: $id) { id name email } }',
        'variables' => ['id' => 123],
    ]),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 10,
    CURLOPT_SSL_VERIFYPEER => false, // 生产环境请勿关闭！应配置 CA 证书
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error    = curl_error($ch);
curl_close($ch);

if ($response === false) {
    throw new RuntimeException("cURL error: {$error}");
}

$data = json_decode($response, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    throw new RuntimeException('Invalid JSON response');
}

if (isset($data['errors'])) {
    throw new RuntimeException('GraphQL errors: ' . json_encode($data['errors']));
}

return $data['data'] ?? [];

⚠️ 常见踩坑点（务必核对）

query 字符串必须是合法 GraphQL 语法：不能换行不转义、变量名要匹配、括号要闭合。建议先在 GraphiQL 或 Altair 中验证。
variables 必须是关联数组，且类型与 schema 一致：比如 ID 类型传字符串 "123" 而非整数 123，否则可能被拒绝。
不要依赖 $_POST 接收：服务端（如 rebing/graphql-laravel）默认只从 php://input 读取原始 JSON，$_POST 为空。
禁止省略 Content-Type: application/json：缺了这个头，Laravel GraphQL 中间件会返回 400 或直接拒收。
生产环境禁用 CURLOPT_SSL_VERIFYPEER => false：应设为 true 并确保系统有可信 CA 证书（如 Ubuntu 的 /etc/ssl/certs/ca-certificates.crt）。

? 更优替代方案（强烈建议）

方案	优势	一行示例
Laravel Http Facade	自动 JSON 编码、异常抛出、可测试、支持超时/重试	`Http::post('/graphql', ['query' => $q, 'variables' => $v])`
Guzzle（推荐）	连接复用、异常分层（`RequestException`/`ConnectException`）、Mock 友好	`$client->post('/graphql', ['json' => [...]])`
GraphQL 客户端 SDK（如 Nuwave/Lighthouse 的 `lighthouse-client`）	自动生成请求结构、类型提示、错误自动映射	`$client->query(...)->user()->id()->execute()`