如何用C++的libcurl将内存缓冲区通过HTTPS上传至服务器

一、正确的libcurl内存缓冲区上传代码 #

你的原有代码存在几个核心问题：重复调用curl_mime_data覆盖配置、手动添加multipart/form-data头画蛇添足、未正确设置文件名和数据长度。以下是完整可运行的C++实现：

#include <curl/curl.h>
#include <iostream>
#include <cstring>

int main() {
    // 初始化curl
    CURL* curl = curl_easy_init();
    if (!curl) {
        std::cerr << "curl初始化失败" << std::endl;
        return 1;
    }

    // 设置HTTPS上传地址（替换为你的实际服务端地址）
    curl_easy_setopt(curl, CURLOPT_URL, "https://127.0.0.1/upload.php");

    // 初始化multipart表单
    curl_mime* form = curl_mime_init(curl);
    if (!form) {
        std::cerr << "mime表单初始化失败" << std::endl;
        curl_easy_cleanup(curl);
        return 1;
    }

    // 添加文件上传字段
    curl_mimepart* part = curl_mime_addpart(form);
    // 绑定表单字段名，需与PHP端的fileToUpload一致
    curl_mime_name(part, "fileToUpload");
    // 设置服务端保存时的文件名
    curl_mime_filename(part, "file.txt");
    // 传入内存缓冲区数据及实际长度（注意用strlen而非sizeof，避免取到指针字节数）
    char* data = "this is the data to upload";
    curl_mime_data(part, data, strlen(data));

    // 将表单绑定到curl请求
    curl_easy_setopt(curl, CURLOPT_MIMEPOST, form);

    // 可选：测试环境跳过SSL证书验证（生产环境必须删除）
    // curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
    // curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);

    // 执行上传请求
    CURLcode res = curl_easy_perform(curl);
    if (res != CURLE_OK) {
        std::cerr << "上传失败: " << curl_easy_strerror(res) << std::endl;
    } else {
        std::cout << "上传成功" << std::endl;
    }

    // 清理资源
    curl_mime_free(form);
    curl_easy_cleanup(curl);
    return 0;
}

关键修正说明 #

• 移除手动添加的multipart/form-data头：libcurl使用CURLOPT_MIMEPOST时会自动生成包含boundary的正确Content-Type头。
• 用curl_mime_filename指定文件名：PHP端$_FILES["fileToUpload"]["name"]会读取该值。
• 正确设置数据长度：strlen(data)获取字符串实际长度，避免sizeof(data)返回指针字节数的错误。
• 避免重复调用curl_mime_data：每次调用会覆盖之前的数据源。

二、无需PHP服务端的上传方案 #

完全可以不用PHP，只要服务端能处理multipart/form-data类型的POST请求即可，以下是两种轻量替代方案：

1. Nginx Upload Module #

直接配置Nginx处理上传，无需后端代码，将文件直接写入指定目录。核心配置示例：

server {
    listen 443 ssl;
    ssl_certificate cert.pem;
    ssl_certificate_key key.pem;

    location /upload {
        upload_pass @upload_handler;
        upload_store /var/www/uploads;
        upload_set_form_field $upload_field_name.name "$upload_file_name";
        upload_set_form_field $upload_field_name.path "$upload_tmp_path";
        upload_aggregate_form_field $upload_field_name.size "$upload_file_size";
    }

    location @upload_handler {
        proxy_pass http://localhost:8080; # 可省略，仅需返回成功响应
        proxy_set_header Content-Type application/x-www-form-urlencoded;
    }
}

2. Go语言简易HTTPS服务端 #

用标准库快速实现上传接口，无需额外依赖：

package main

import (
    "io"
    "os"
    "net/http"
)

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    r.ParseMultipartForm(10 << 20) // 设置10MB上传上限
    file, handler, err := r.FormFile("fileToUpload")
    if err != nil {
        w.WriteHeader(http.StatusBadRequest)
        w.Write([]byte("获取文件失败"))
        return
    }
    defer file.Close()

    // 创建保存目录
    os.MkdirAll("./uploads", 0755)
    dst, err := os.Create("./uploads/" + handler.Filename)
    if err != nil {
        w.WriteHeader(http.StatusInternalServerError)
        w.Write([]byte("创建文件失败"))
        return
    }
    defer dst.Close()

    _, err = io.Copy(dst, file)
    if err != nil {
        w.WriteHeader(http.StatusInternalServerError)
        w.Write([]byte("保存文件失败"))
        return
    }
    w.Write([]byte("文件上传成功"))
}

func main() {
    http.HandleFunc("/upload", uploadHandler)
    // 开启HTTPS，需提前生成证书文件
    http.ListenAndServeTLS(":443", "cert.pem", "key.pem", nil)
}

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