本文详解如何使用 PHP cURL 实现带文件上传（curl_file_create）和多值数组字段（如 colours[]）的 multipart/form-data 表单提交，避免“Array to string conversion”错误及 415 错误。
本文详解如何使用 php curl 实现带文件上传（`curl_file_create`）和多值数组字段（如 `colours[]`）的 multipart/form-data 表单提交，避免“array to string conversion”错误及 415 错误。
在 PHP 中通过 cURL 提交包含文件和数组字段的表单时，关键在于理解 CURLOPT_POSTFIELDS 对数组参数的处理机制：当传入关联数组且值为字符串（而非嵌套数组）时，cURL 会自动以 multipart/form-data 方式编码，并支持类似 HTML 表单中 name[] 的语法——但 PHP 数组本身不允许多个相同键名，因此必须显式展开为带索引的键名（如 'colours[0]'、'colours[1]'）。
以下为完整、可直接运行的示例代码：
$url = 'https://the.url.com/upload';
$file = '/path/to/the/file';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 获取响应内容而非直接输出
curl_setopt($ch, CURLOPT_HTTPHEADER, [
// 可选：显式设置 Accept 头（部分 API 要求）
'Accept: application/json',
]);
// ✅ 正确构造 POST 字段：文件用 CURLFile，数组字段拆解为带索引的键
$postFields = [
'file' => curl_file_create($file), // PHP 5.5+ 推荐方式（注意路径需真实存在）
'colours[0]' => 'red',
'colours[1]' => 'yellow',
'colours[2]' => 'blue',
];
curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException('cURL error: ' . curl_error($ch));
}
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo "HTTP Status: {$httpCode}\n";
echo "Response: {$response}\n";⚠️ 重要注意事项：
CurlShip Directory Submission
下载
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
- 不要直接传递 colours => ['red','yellow','blue']：这会导致 PHP 尝试将整个数组转为字符串（触发 Array to string conversion 错误），因为 cURL 不支持对值为数组的键进行自动展开。
- 避免 http_build_query() 包裹整个数组：它会生成 application/x-www-form-urlencoded 格式（非 multipart），导致服务端返回 415 Unsupported Media Type —— 文件上传必须使用 multipart/form-data。
- curl_file_create() 路径必须有效：若文件不存在或权限不足，cURL 会静默失败或返回空响应；建议提前校验 file_exists($file) && is_readable($file)。
- 兼容性提醒：CURLFile 自 PHP 5.5.0 引入；若使用旧版本，请改用 @/absolute/path 语法（已弃用，不推荐）。
- 调试技巧：启用 curl_setopt($ch, CURLOPT_VERBOSE, true) 并配合 fopen('php://temp', 'w+') 可捕获详细请求头与体，便于排查编码问题。
总结：PHP cURL 的 CURLOPT_POSTFIELDS 数组模式天然支持 name[index] 形式键名，这是模拟 HTML 多值表单字段（）的标准实践。只要确保文件字段使用 CURLFile 实例、数组字段手动索引展开，并保持整体为关联数组结构，即可可靠实现复杂表单提交。
立即学习“PHP免费学习笔记（深入）”；
