laravel 10 中推荐使用 http facade 或 guzzlehttp\client；手动调用原生 curl 仅适用于调试或特殊控制需求，设置请求体需正确配置 curlopt_postfields、curlopt_post 和 content-type 等选项。
在 Laravel 10 中，cURL 并不是框架内置的 HTTP 客户端，它只是 PHP 的底层扩展。Laravel 默认推荐使用 GuzzleHttp\Client（已预装）或 Http facade 发起请求；但若你明确需要手动调用原生 cURL（比如调试、特殊 header 控制、或绕过 Guzzle 封装），启动时设置请求体的关键在于正确配置 CURLOPT_POSTFIELDS 和相关选项。
明确请求方法与请求体类型
请求体（body）是否生效，取决于请求方式和内容格式：
- POST/PUT/PATCH 请求才允许携带请求体；GET、HEAD 不支持
- 发送 JSON 数据：需设
CURLOPT_POSTFIELDS为json_encode($data)，并手动加Content-Type: application/jsonheader - 发送表单数据（x-www-form-urlencoded）：设
CURLOPT_POSTFIELDS为关联数组（如['name' => 'Tom', 'email' => 't@ex.com']），cURL 会自动编码 - 发送文件+字段（multipart/form-data）：必须用
CURLFile实例构造字段，不能直接传文件路径字符串
基础 cURL POST 请求体设置示例
以下是在控制器或命令中手动初始化 cURL 并设置请求体的最小可行代码：
Leaf Curling & Margin Scorch Diagnosis | 植物卷叶/焦边识别（干旱/病害）
下载
利用农业相机拍摄植物叶片高分辨率图像，通过AI视觉技术检测叶片卷曲方向（向上卷曲或向下卷曲）
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/v1/users');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// ✅ 正确：JSON 请求体
$data = ['name' => 'Alice', 'role' => 'admin'];
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer abc123'
]);
// ✅ 正确：表单请求体（自动 urlencode）
// curl_setopt($ch, CURLOPT_POSTFIELDS, ['name' => 'Alice', 'role' => 'admin']);
// ✅ 正确：含文件的 multipart 请求体
// $file = new \CURLFile('/tmp/avatar.jpg', 'image/jpeg', 'avatar.jpg');
// curl_setopt($ch, CURLOPT_POSTFIELDS, ['name' => 'Alice', 'avatar' => $file]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
常见错误与避坑点
很多请求体“不生效”，其实是配置遗漏或语义混淆：
-
漏掉
CURLOPT_POST或设为false：即使有CURLOPT_POSTFIELDS，cURL 默认仍发 GET，请求体被忽略 -
JSON 数据没加
Content-Typeheader：服务端可能拒收或解析为字符串，而非 JSON 对象 -
误用
CURLOPT_POSTFIELDS传数组发 JSON：会导致 cURL 发送name=Alice&role=admin，而非 JSON 字符串 -
文件上传未用
CURLFile：直接传路径字符串会被当作文本内容发送，服务端收不到二进制文件 -
中文或特殊字符未 UTF-8 编码：建议统一确保
$data是 UTF-8 字符串，必要时用mb_convert_encoding()
替代方案更推荐：用 Guzzle 或 Http facade
除非有强定制需求（如自定义 SSL 验证、低层 socket 控制），否则不建议手写 cURL。Laravel 10 原生支持：
-
Http::asJson()->post($url, $data)→ 自动设 header + json_encode -
Http::attach('file', file_get_contents($path), 'report.pdf')->post($url, $form)→ 文件上传更安全简洁 -
$client = new \GuzzleHttp\Client(['timeout' => 10]); $client->post($url, ['json' => $data])→ 更细粒度控制
