laravel 11 中用 curl 上传文件需以数组形式传 curlopt_postfields，使用 curlfile 对象（非 @ 语法），由 curl 自动构造 multipart/form-data 及 boundary；禁用手动设 content-type，避免 php 版本兼容问题，并确保服务端路由、php 配置及 csrf 等中间件适配。
在 Laravel 11 中，cURL 本身不运行在 Laravel 内部，而是你用 PHP 的 curl_init() 在控制器、命令或服务中发起外部 HTTP 请求——比如调用另一个 API 上传文件。关键不是“Laravel 怎么用 cURL”，而是PHP 怎么用 cURL 正确构造 multipart/form-data 请求，尤其要避开常见坑点。
必须用 CURLOPT_POSTFIELDS 数组，别手动拼 boundary
错误做法：自己写字符串、硬编码 Content-Type、手算 boundary。这极易出错，服务器无法解析。
正确做法：把文件路径和字段数据组织成关联数组，交给 cURL 自动组装：
- 用
@/path/to/file.jpg（PHP 8.1+ 推荐）或CURLFile对象（兼容旧版）表示文件 - 普通字段如
title、user_id直接作为键值对加入数组 - 完全不设置
Content-Type头——cURL 会自动生成带正确 boundary 的 multipart 头
示例代码：
Leaf Curling & Margin Scorch Diagnosis | 植物卷叶/焦边识别（干旱/病害）
下载
利用农业相机拍摄植物叶片高分辨率图像，通过AI视觉技术检测叶片卷曲方向（向上卷曲或向下卷曲）
$ch = curl_init('https://api.example.com/upload');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 关键：用数组传参，cURL 自动处理 multipart
$postData = [
'file' => new CURLFile('/var/www/uploads/photo.png', 'image/png', 'photo.png'),
'title' => 'My Upload',
'category' => 'avatar'
];
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
$response = curl_exec($ch);
curl_close($ch);
注意 PHP 版本与 @ 语法兼容性
PHP 5.5–8.0 支持 @/path 写法，但 PHP 8.1+ 默认禁用，需开启 curl.file 或改用 CURLFile。
- 若用
@/path，确保 php.ini 中curl.file = On（不推荐，已过时） - Laravel 11 项目建议统一用
CURLFile，避免版本差异问题 - 上传多个文件时，数组字段名加
[]，如'photos[]' => new CURLFile(...)
服务端是 Laravel？别漏掉 CSRF 和中间件
如果你的 cURL 是发给自己的 Laravel 应用（比如测试上传接口），要注意：
- API 路由默认不启用 CSRF 验证，但如果是
web中间件组下的路由，需传_token字段 - 确保目标路由没被限流、没被 CORS 中间件拦截（开发期可临时关掉）
- 检查
php.ini：upload_max_filesize、post_max_size 必须 ≥ 你传的文件大小
调试技巧：用 curl_getinfo() 和日志看真实请求
上传失败时，光看响应体不够，要确认请求是否真的发出了 multipart：
- 调用
curl_getinfo($ch, CURLINFO_CONTENT_TYPE)，应返回类似multipart/form-data; boundary=----WebKitFormBoundary... - 在 Laravel 后端用
Log::debug(request()->all());查看是否收到file字段 - 如果
request()->file('file')为 null，90% 是 cURL 没走 multipart 路径，回头检查CURLOPT_POSTFIELDS是否用了数组
