使用curl上传带有文件的POST数据

本文翻译自：Using curl to upload POST data with files

I would like to use cURL to not only send data parameters in HTTP POST but to also upload files with specific form name. 我想使用cURL不仅在HTTP POST中发送数据参数，而且还上传具有特定表单名称的文件。 How should I go about doing that ? 我应该怎么做呢？

HTTP Post parameters: HTTP Post参数：

userid = 12345 filecomment = This is an image file userid = 12345 filecomment =这是一个图像文件

HTTP File upload: File location = /home/user1/Desktop/test.jpg Form name for file = image (correspond to the $_FILES['image'] at the PHP side) HTTP文件上传：文件位置= /home/user1/Desktop/test.jpg文件的表单名称= image（对应于PHP端的$ _​​FILES ['image']）

I figured part of the cURL command as follows: 我认为cURL命令的一部分如下：

curl -d "userid=1&filecomment=This is an image file" --data-binary @"/home/user1/Desktop/test.jpg" localhost/uploader.php

The problem I am getting is as follows: 我遇到的问题如下：

Notice: Undefined index: image in /var/www/uploader.php

The problem is I am using $_FILES['image'] to pick up files in the PHP script. 问题是我正在使用$ _FILES ['image']在PHP脚本中拾取文件。

How do I adjust my cURL commands accordingly ? 如何相应地调整cURL命令？

---

#1楼

参考：https://stackoom.com/question/r9TJ/使用curl上传带有文件的POST数据

---

#2楼

You need to use the -F option: 您需要使用-F选项：
-F/--form <name=content> Specify HTTP multipart POST data (H)

Try this: 尝试这个：

curl \
  -F "userid=1" \
  -F "filecomment=This is an image file" \
  -F "image=@/home/user1/Desktop/test.jpg" \
  localhost/uploader.php

---

#3楼

Here is my solution, I have been reading a lot of posts and they were really helpful. 这是我的解决方案，我已经阅读了很多帖子，它们确实很有帮助。 Finally I wrote some code for small files, with cURL and PHP that I think its really useful. 最后，我用cURL和PHP编写了一些用于小文件的代码，我认为它确实很有用。

public function postFile()
{    
        $file_url = "test.txt";  //here is the file route, in this case is on same directory but you can set URL too like "http://examplewebsite.com/test.txt"
        $eol = "\r\n"; //default line-break for mime type
        $BOUNDARY = md5(time()); //random boundaryid, is a separator for each param on my post curl function
        $BODY=""; //init my curl body
        $BODY.= '--'.$BOUNDARY. $eol; //start param header
        $BODY .= 'Content-Disposition: form-data; name="sometext"' . $eol . $eol; // last Content with 2 $eol, in this case is only 1 content.
        $BODY .= "Some Data" . $eol;//param data in this case is a simple post data and 1 $eol for the end of the data
        $BODY.= '--'.$BOUNDARY. $eol; // start 2nd param,
        $BODY.= 'Content-Disposition: form-data; name="somefile"; filename="test.txt"'. $eol ; //first Content data for post file, remember you only put 1 when you are going to add more Contents, and 2 on the last, to close the Content Instance
        $BODY.= 'Content-Type: application/octet-stream' . $eol; //Same before row
        $BODY.= 'Content-Transfer-Encoding: base64' . $eol . $eol; // we put the last Content and 2 $eol,
        $BODY.= chunk_split(base64_encode(file_get_contents($file_url))) . $eol; // we write the Base64 File Content and the $eol to finish the data,
        $BODY.= '--'.$BOUNDARY .'--' . $eol. $eol; // we close the param and the post width "--" and 2 $eol at the end of our boundary header.



        $ch = curl_init(); //init curl
        curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                         'X_PARAM_TOKEN : 71e2cb8b-42b7-4bf0-b2e8-53fbd2f578f9' //custom header for my api validation you can get it from $_SERVER["HTTP_X_PARAM_TOKEN"] variable
                         ,"Content-Type: multipart/form-data; boundary=".$BOUNDARY) //setting our mime type for make it work on $_FILE variable
                    );
        curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/1.0 (Windows NT 6.1; WOW64; rv:28.0) Gecko/20100101 Firefox/28.0'); //setting our user agent
        curl_setopt($ch, CURLOPT_URL, "api.endpoint.post"); //setting our api post url
        curl_setopt($ch, CURLOPT_COOKIEJAR, $BOUNDARY.'.txt'); //saving cookies just in case we want
        curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1); // call return content
        curl_setopt ($ch, CURLOPT_FOLLOWLOCATION, 1); navigate the endpoint
        curl_setopt($ch, CURLOPT_POST, true); //set as post
        curl_setopt($ch, CURLOPT_POSTFIELDS, $BODY); // set our $BODY 


        $response = curl_exec($ch); // start curl navigation

     print_r($response); //print response

}

With this we should be get on the "api.endpoint.post" the following vars posted. 有了这个，我们应该在以下变量上找到“ api.endpoint.post”。 You can easily test with this script, and you should be receive this debugs on the function postFile() at the last row. 您可以轻松地使用此脚本进行测试，并且应该在最后一行的函数postFile()上收到此调试信息。

print_r($response); //print response

public function getPostFile()
{

    echo "\n\n_SERVER\n";
    echo "<pre>";
    print_r($_SERVER['HTTP_X_PARAM_TOKEN']);
    echo "/<pre>";
    echo "_POST\n";
    echo "<pre>";
    print_r($_POST['sometext']);
    echo "/<pre>";
    echo "_FILES\n";
    echo "<pre>";
    print_r($_FILEST['somefile']);
    echo "/<pre>";
}

It should work well, they may be better solutions but this works and is really helpful to understand how the Boundary and multipart/from-data mime works on PHP and cURL library. 它应该可以很好地工作，它们可能是更好的解决方案，但是它可以工作，并且对于理解Boundary和multipart / from-data mime如何在PHP和cURL库上工作非常有帮助。

---

#4楼

Catching the user id as path variable (recommended): 将用户ID捕获为路径变量（推荐）：

curl -i -X POST -H "Content-Type: multipart/form-data" 
-F "data=@test.mp3" http://mysuperserver/media/1234/upload/

Catching the user id as part of the form: 捕获用户ID作为表单的一部分：

curl -i -X POST -H "Content-Type: multipart/form-data" 
-F "data=@test.mp3;userid=1234" http://mysuperserver/media/upload/

or: 要么：

curl -i -X POST -H "Content-Type: multipart/form-data" 
-F "data=@test.mp3" -F "userid=1234" http://mysuperserver/media/upload/

---

#5楼

Here is how to correctly escape arbitrary filenames of uploaded files with bash : 这是使用bash正确转义上传文件的任意文件名的方法：

#!/bin/bash
set -eu

f="$1"
f=${f//\\/\\\\}
f=${f//\"/\\\"}
f=${f//;/\\;}

curl --silent --form "uploaded=@\"$f\"" "$2"

---

#6楼

if you are uploading binary file such as csv, use below format to upload file 如果您要上传二进制文件（例如csv），请使用以下格式上传文件

curl -X POST \
    'http://localhost:8080/workers' \
    -H 'authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6ImFjY2VzcyIsInR5cGUiOiJhY2Nlc3MifQ.eyJ1c2VySWQiOjEsImFjY291bnRJZCI6MSwiaWF0IjoxNTExMzMwMzg5LCJleHAiOjE1MTM5MjIzODksImF1ZCI6Imh0dHBzOi8veW91cmRvbWFpbi5jb20iLCJpc3MiOiJmZWF0aGVycyIsInN1YiI6ImFub255bW91cyJ9.HWk7qJ0uK6SEi8qSeeB6-TGslDlZOTpG51U6kVi8nYc' \
    -H 'content-type: application/x-www-form-urlencoded' \
    --data-binary '@/home/limitless/Downloads/iRoute Masters - Workers.csv'