在 Laravel 8 中使用 PHP 原生 cURL 发送 multipart/form-data 请求，必须用 CURLFile 类（或命令行 -F 参数），不可手动设 Content-Type 或用 -d；cURL 会自动添加含 boundary 的正确头及请求体，手动指定会导致 400/405 错误。
在 Laravel 8 中，cURL 本身是 PHP 的底层扩展，不依赖 Laravel 框架运行；所谓“Laravel 8 怎样用 cURL 发送 MultipartFormData”，实际是指：在 Laravel 8 项目中（比如控制器、命令或服务类里），用 PHP 原生 curl_init() 正确构造并发送 multipart/form-data 请求——尤其用于调用第三方文件上传接口，或向另一个 Laravel API 传文件。
必须用 -F 参数（命令行）或 CURLFile（PHP 代码）
不能用 -d、--data-raw 或手动拼接 boundary。浏览器和服务器靠 CURLFile 自动注入的 boundary 字符串识别字段边界。手写 Content-Type 或 body 会直接失败。
- 命令行测试（如调试接口）：
curl -X POST http://api.example.com/upload -F "file=@/path/to/image.jpg" -F "title=My Photo" - PHP 代码中（Laravel 环境下可用）：
$cfile = new \CURLFile('/path/to/image.jpg', 'image/jpeg', 'image.jpg'); - 然后传入
curl_setopt($ch, CURLOPT_POSTFIELDS, ['file' => $cfile, 'title' => 'My Photo']);
别手动设 Content-Type 头
cURL 使用 CURLFile 或 -F 时，会自动设置 Content-Type: multipart/form-data; boundary=xxxx，并正确组织 body。如果额外加 curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: multipart/form-data'])，反而会覆盖自动头，导致 400 或解析失败。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- ✅ 正确：不设 Content-Type，让 cURL 自动处理
- ❌ 错误：显式指定
Content-Type: multipart/form-data（缺 boundary）或Content-Type: multipart/form-data; boundary=abc（boundary 不匹配 body）
注意文件路径与权限
CURLFile 构造时传入的路径必须是服务器本地绝对路径，且 PHP 进程有读取权限。相对路径容易出错，建议用 public_path() 或 storage_path() 显式拼接。
- 例如上传用户刚存到
storage/app/tmp/的临时文件：new \CURLFile(storage_path('app/tmp/photo.png')) - 若文件来自请求（
$request->file('avatar')），先store()到本地磁盘再传，不要直接用内存流或临时路径（$_FILES['avatar']['tmp_name']可能已被清理）
常见错误响应及对应原因
返回 405 Method Not Allowed？可能是目标接口只接受 POST，但你发了 GET；返回空数组或 400？大概率是没用 CURLFile 或路径无效；返回 413 Request Entity Too Large？需检查对方 Nginx 的 client_max_body_size 和 PHP 的 upload_max_filesize，而非你这端。
- 405：确认
curl_setopt($ch, CURLOPT_POST, true)已开启，且 URL 路由支持 POST - 空文件或
$_FILES为空：对方后端是否用了 Laravel？它默认不解析非表单提交的 multipart，需确保他们也按规范接收（如用$request->file('file')） - 超时或连接拒绝：检查目标域名能否从当前服务器 ping 通，防火墙是否放行
