使用PHP cURL通过API上传图片功能不生效问题求助

常见问题原因 #

• 手动设置了Content-Type: multipart/form-data但未指定boundary值，cURL传递数组格式的CURLOPT_POSTFIELDS时会自动生成带有效boundary的请求头，手动设置会覆盖正确配置，导致服务端无法解析上传的文件
• CURLFILE实例仅传临时路径不符合要求，大部分API会校验文件原名和MIME类型，缺失信息会被判定为无效文件
• 缺少本地文件上传校验逻辑，$_FILES['cfile']['tmp_name']可能因前端表单未加enctype="multipart/form-data"、文件大小超出PHP配置限制等原因为空，导致读取文件失败
• 没有cURL请求错误调试逻辑，无法区分是请求层面出错还是接口返回业务错误

修复后的代码 #

// 先校验本地文件上传状态
if ($_FILES['cfile']['error'] !== UPLOAD_ERR_OK) {
    die('本地文件上传失败，错误码：' . $_FILES['cfile']['error']);
}
$tmpPath = $_FILES['cfile']['tmp_name'];
$fileName = $_FILES['cfile']['name'];
$fileMime = mime_content_type($tmpPath);

$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_URL => '替换为实际API地址',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'POST',
    // 补全CURLFILE的全部参数
    CURLOPT_POSTFIELDS => array(
        'file' => new CURLFILE($tmpPath, $fileMime, $fileName)
    ),
));

$response = curl_exec($curl);
// 新增cURL请求错误判断
if(curl_errno($curl)){
    die('cURL请求错误：' . curl_error($curl));
}

curl_close($curl);
echo $response;

额外校验项 #

• 确认前端提交表单的<form>标签已添加enctype="multipart/form-data"属性
• 确认API要求的文件参数名是否为file，部分接口可能使用image、upload等其他参数名
• 确认API是否要求额外鉴权参数，比如token、签名等，需要和文件参数一起放入CURLOPT_POSTFIELDS数组中

内容的提问来源于stack exchange，提问作者Archana Patil