curl post https_Linux命令cURL详解，并实现文件定时上传到ftp服务器的程序

前言

前段时间群里讨论，想实现某个文件定时上传到服务器要怎么来实现。我记得之前做过一个项目：为高通的iot模组编写FOTA功能：实现模组可以远程下载升级镜像包，实现版本升级功能。并当时使用的一个超级强大的工具cURL。心血来潮，决定专门写一篇文章，送给需要的朋友。

文章分两部分

首先介绍cURL的用法；
实现一个定时上传日志文件的一个简单的程序。

概念

cURL 是常用的命令行工具，用来请求 Web 服务器。它的名字就是客户端（client）的 URL 工具的意思。

cURL 的原作者是 Daniel Stenberg （目前是 cURL 的核心开发者），同时也是 IETF HTTPbis 工作组的资深成员。Daniel 在 1998 年创建了 curl 项目，他编写了最初的 curl 版本，并创建了 libcurl 库。到目前为止，代码仓库包括的 24000 次 commit 有超过一半是 Daniel 本人提交的，他依然是项目的核心开发者。Daniel 表示已将 curl 视为自己的孩子。

作为一款强力工具，支持的协议包括 (DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMTP, SMTPS, TELNET and TFTP)，还支持POST、cookies、认证、从指定偏移处下载部分文件等功能，具有用户代理字符串、限速、文件大小、进度条、cookie支持、用户认证、断点续传等特征。

一、命令的安装

sudo apt-get install curl

二、cURL命令语法：

curl [options] [URL...]

三、URL格式

URL的格式定义要参考 RFC 1808 。

地址：http://www.w3.org/Addressing/rfc1808.txt
《Relative Uniform Resource Locators 》

URL由三部分组成：资源类型、存放资源的主机域名、资源文件名。也可认为由4部分组成：协议、主机、端口、路径 URL的一般语法格式为：

protocol :// hostname[:port] / path / [;parameters][?query]#fragment

(带方括号[]的为可选项)。

protocol（协议）

指定使用的传输协议，下表列出 protocol 属性的有效方案名称。最常用的是HTTP协议，它也是WWW中应用最广的协议。

file 资源是本地计算机上的文件。格式file:///，注意后边应是三个斜杠。
ftp 通过 FTP访问资源。格式 FTP://
gopher 通过 Gopher 协议访问该资源。
http 通过 HTTP 访问该资源。格式 HTTP://
https 通过安全的 HTTPS 访问该资源。格式 HTTPS://
mailto 资源为电子邮件地址，通过 SMTP 访问。格式 mailto:
MMS 通过支持MMS（流媒体）协议的播放该资源。（代表软件：Windows Media Player）格式 MMS://
ed2k 通过支持ed2k（专用下载链接）协议的P2P软件访问该资源。（代表软件：电驴）格式 ed2k://
Flashget 通过支持Flashget:（专用下载链接）协议的P2P软件访问该资源。（代表软件：快车）格式 Flashget://
thunder 通过支持thunder（专用下载链接）协议的P2P软件访问该资源。（代表软件：迅雷）格式 thunder://
news 通过 NNTP 访问该资源。

hostname（主机名）

是指存放资源的服务器的域名系统(DNS) 主机名或 IP 地址。有时，在主机名前也可以包含连接到服务器所需的用户名和密码（格式：username:password@hostname）。

port（端口号）

整数，可选，省略时使用方案的默认端口，各种传输协议都有默认的端口号，如http的默认端口为80。如果输入时省略，则使用默认端口号。有时候出于安全或其他考虑，可以在服务器上对端口进行重定义，即采用非标准端口号，此时，URL中就不能省略端口号这一项。

path（路径）

由零或多个“/”符号隔开的字符串，一般用来表示主机上的一个目录或文件地址。

parameters（参数）

这是用于指定特殊参数的可选项。

query(查询)

可选，用于给动态网页（如使用CGI、ISAPI、PHP/JSP/ASP/http://ASP.NET等技术制作的网页）传递参数，可有多个参数，用“&”符号隔开，每个参数的名和值用“=”符号隔开。

fragment（信息片断）

字符串，用于指定网络资源中的片断。例如一个网页中有多个名词解释，可使用fragment直接定位到某一名词解释。

四、curl命令参数详解：

由于linux curl功能十分强大，所以命令参数十分多，下表只筛选出来部分常用的参数，更多参数请运行“man curl”命令查看。

ble data-draft-node="block" data-draft-type="table" data-size="normal" data-row-style="normal">

五、Linux curl命令退出码：

下面是linux curl命令的错误代码和她们的相应的错误消息，命令执行错误的时候可以通过错误码来查看出错原因，方便开发调试。

ble data-draft-node="block" data-draft-type="table" data-size="normal" data-row-style="normal">

六、用法演示：

为节省篇幅，部分操作不再贴上执行结果。

1、查看网页源码

直接在curl命令后加上网址，就可以看到网页源码。我们以网址http://www.sina.com为例（选择该网址，主要因为它的网页代码较短）：

root@ubuntu:/home/peng# curl www.sohu.com
<html>
<head><title>307 Temporary Redirect</title></head>
<body bgcolor="white">
<center><h1>307 Temporary Redirect</h1></center>
<hr><center>nginx</center>
</body>
</html>

执行结果显示 307 Temporary Redirect，说明该网址需要重定向。

如果要把这个网页保存下来，可以使用-o参数，这就相当于使用wget命令了。

curl -o [文件名] www.sohu.com

2、自动跳转

有的网址是自动跳转的。使用-L参数，curl就会跳转到新的网址。

curl -L www.sohu.com

键入上面的命令，结果就自动跳转为http://www.sohu.com.cn。

3、显示头信息

-i参数可以显示http response的头信息，连同网页代码一起。

root@ubuntu:/home/peng/driver/test#  curl -i www.sohu.com
HTTP/1.1 307 Temporary Redirect
Content-Type: text/html
Content-Length: 180
Connection: keep-alive
Server: nginx
Date: Tue, 25 Aug 2020 10:10:54 GMT
Location: https://www.sohu.com/
FSS-Cache: from 9790436.18244590.10468709
FSS-Proxy: Powered by 2384755.3433341.3062915<html>
<head><title>307 Temporary Redirect</title></head>
<body bgcolor="white">
<center><h1>307 Temporary Redirect</h1></center>
<hr><center>nginx</center>
</body>
</html>

-I参数则是只显示http response的头信息。

4、显示通信过程

-v参数可以显示一次http通信的整个过程，包括端口连接和http request头信息。

root@ubuntu:/home/peng/driver/test#  curl -v www.sohu.com
* About to connect() to www.sohu.com port 80 (#0)
*   Trying 240e:83:201:3700::5... connected
> GET / HTTP/1.1
> User-Agent: curl/7.22.0 (i686-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3
> Host: www.sohu.com
> Accept: */*
>
< HTTP/1.1 307 Temporary Redirect
< Content-Type: text/html
< Content-Length: 180
< Connection: keep-alive
< Server: nginx
< Date: Tue, 25 Aug 2020 10:11:49 GMT
< Location: https://www.sohu.com/
< FSS-Cache: from 9855973.18375663.10534247
< FSS-Proxy: Powered by 2450292.3564414.3128453
<
<html>
<head><title>307 Temporary Redirect</title></head>
<body bgcolor="white">
<center><h1>307 Temporary Redirect</h1></center>
<hr><center>nginx</center>
</body>
</html>
* Connection #0 to host www.sohu.com left intact
* Closing connection #0

如果你觉得上面的信息还不够，那么下面的命令可以查看更详细的通信过程。

curl --trace output.txt www.sohu.com

或者

curl --trace-ascii output.txt www.sohu.com

运行后，请打开output.txt文件查看。

5、发送表单信息

发送表单信息有GET和POST两种方法。GET方法相对简单，只要把数据附在网址后面就行。

curl example.com/form.cgi?data=xxx

POST方法必须把数据和网址分开，curl就要用到--data参数。

curl -X POST --data "data=xxx" example.com/form.cgi

如果你的数据没有经过表单编码，还可以让curl为你编码，参数是--data-urlencode。

curl -X POST--data-urlencode "date=April 1" example.com/form.cgi

6、HTTP动词

curl默认的HTTP动词是GET，使用-X参数可以支持其他动词。

curl -X POST www.example.com
curl -X DELETE www.example.com

7、文件上传

假定文件上传的表单是下面这样：

<form method="POST" enctype='multipart/form-data' action="upload.cgi"><input type=file name=upload><input type=submit name=press value="OK">
</form>

你可以用curl这样上传文件：

curl --form upload=@localfilename --form press=OK [URL]

8、Referer字段

有时你需要在http request头信息中，提供一个referer字段，表示你是从哪里跳转过来的。

curl --referer http://www.example.com http://www.example.com

9、User Agent字段

这个字段是用来表示客户端的设备信息。服务器有时会根据这个字段，针对不同设备，返回不同格式的网页，比如手机版和桌面版。

iPhone4的User Agent是

Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_0 like Mac OS X; en-us) AppleWebKit/532.9 (KHTML, like Gecko) Version/4.0.5 Mobile/8A293 Safari/6531.22.7

curl可以这样模拟：

curl --user-agent "[User Agent]" [URL]

10、cookie

使用--cookie参数，可以让curl发送cookie。

curl --cookie "name=xxx" www.example.com

至于具体的cookie的值，可以从http response头信息的Set-Cookie字段中得到。

-c cookie-file可以保存服务器返回的cookie到文件，-b cookie-file可以使用这个文件作为cookie信息，进行后续的请求。

curl -c cookies http://example.com
curl -b cookies http://example.com

11、增加头信息

有时需要在http request之中，自行增加一个头信息。--header参数就可以起到这个作用。

$ curl --header "Content-Type:application/json" http://example.com

12、认证

使用curl选项 -u 可以完成HTTP或者FTP的认证，可以指定密码，也可以不指定密码在后续操作中输入密码：

curl -u user:pwd http://man.linuxde.net
curl -u user http://man.linuxde.net

13、FTP

1)、列出ftp服务器上的目录列表

curl ftp://www.xxx.com/ --user name:passwd
curl ftp://www.xxx.com/ –u name:passwd #简洁写法
curl ftp://name:passwd@www.xxx.com #简洁写法2

例如：在IP地址192.168.43.117上搭建FTP服务器，并设置用户名为user，密码为123456 现在我们要显示服务器上根目录下的所有文件信息，命令如下：

curl -u user:123456 ftp://192.168.43.117

执行结果如下：

简洁写法：

curl ftp://user:123456@192.168.43.117

执行结果如下：

2)、只列出目录，不显示进度条

curl ftp://www.xxx.com –u name:passwd -s

3)、下载一个文件：

格式

curl ftp://www.xxx.com/size.zip –u name:passwd -o size.zip

示例如下：从服务器的根目录下下载文件test.c，保存到本地，本地文件名也为test.c。【注意】如果没有-o选项，程序会吧数据流定向到stdout，即直接把文件内容显示到终端上。

curl ftp://user:123456@192.168.43.117/test.c -o test.c

执行结果如下：

简洁模式

curl -u user:123456 ftp://192.168.43.117/list.h -o list.h

执行结果如下：

4)、上载一个文件：

curl –u name:passwd -T size.mp3 ftp://www.xxx.com/mp3/

举例如下：

curl -u user:123456 ftp://192.168.43.117/ -T list.h

可以看到文件并没有上传成功，返回错误码是25，参考第五章

25 FTP couldn't STOR file. The server denied the STOR operation, used for FTP uploading.

可知，是因为服务器没有赋予存储的权限，所以设置服务器的write权限即可。

5)、从服务器上删除文件（使用curl传递ftp协议的DELE命令）:

curl –u name:passwd ftp://www.xxx.com/ -X 'DELE mp3/size.mp3'

6)、另外curl不支持递归下载，不过可以用数组方式下载文件，比如我们要下载1-10.gif连续命名的文件：**

curl –u name:passwd ftp://www.xxx.com/img/[1-10].gif –O #O字母大写

7)、要连续下载多个文件：

curl –u name:passwd ftp://www.xxx.com/img/[one,two,three].jpg –O #O字母大写

六、实现日志文件定时上传

功能

程序运行时要记录当前日志文件的最后修改时间；
每个10秒钟就检查下log文件是否被修改，如果没有被修改就休眠10秒钟；
如果log文件被修改了，就将当前的日志文件拷贝成备份文件，备份文件名字加上当前时间；
通过curl发送给ftp服务器；
删除备份文件，重复步骤2。

程序流程图如下：

函数功能介绍

init()

首先记录当前log文件时间，并记录到全局变量last_mtime中。

check_file_change()

读取文件最后修改时间，并和last_mtime进行比较，如果相同就返回0，不同就返回1.

file_name_add_time()

将当前的日志文件拷贝成备份文件，备份文件名字加上当前时间。

stat()

得到对应文件的属性信息，存放到struct stat结构体变量中。

system()

执行参数中字符串对应的命令

代码如下：

/*   Copyright (C)   公众号: yikoulinux  */
#include <sys/stat.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <time.h>typedef struct stat ST;
unsigned long last_mtime;/*用户名密码暂时写死，实际应该保存在配置文件*/
char name[32]="user";
char pass[32] ="123456";
char ip[32]     ="192.168.43.117";
char filename[32]="t.log";
char dstfile[256]  ={0};int init(void)
{//准备结构体ST status;//调用stat函数int res = stat(filename,&status);if(-1 == res){perror("error:open file failn");return 0;}last_mtime = status.st_mtime;printf("init time:%s n",ctime(&last_mtime));return 1;
}int  check_file_change(void)
{//准备结构体ST status;//调用stat函数int res = stat(filename,&status);if(-1 == res){perror("error:open file failn");return 0;}
// printf("old:%s new:%s",ctime(&last_mtime),ctime(&status.st_mtime));if(last_mtime == status.st_mtime){printf("file not changen");return 0;}else{printf("file updatedn"); last_mtime = status.st_mtime;return 1;}}
void file_name_add_time(void)
{ST status;time_t t;  struct tm *tblock; char cmd[1024]={0};t = time(NULL);tblock = localtime(&t);sprintf(dstfile,"t-%d-%d-%d-%d-%d-%d.log",tblock->tm_year+1900,tblock->tm_mon,tblock->tm_mday,tblock->tm_hour,tblock->tm_min,tblock->tm_sec);sprintf(cmd,"cp %s %s",filename,dstfile);
// printf("cdm=%sn",cmd);system(cmd);
}
int main(void)
{char cmd[1024]={0};init();while(1){ if(check_file_change() == 1){file_name_add_time();sprintf(cmd,"curl -u %s:%s ftp://%s/ -T %s",name,pass,ip,dstfile);//  printf("cdm=%sn",cmd);system(cmd);unlink(dstfile);}sleep(10); }
}

运行截图：

第一步：

因为log文件没有被修改过，所以程序不会上传。

第二步： 手动输入字符串 yikoulinux 到日志文件 t.log中。

第三步：因为文件发生了改变，所以打印“file updated”，同时可以看到curl上传文件的log信息。

以下是FTP服务器的根目录，可以看到，上传的日志文件:t-2020-7-26-1-19-45.log。

【补充】

配置信息，直接在代码中写死，通常应该从配置文件中读取，为方便读者阅读，本代码没有增加该功能；
FTP服务器搭建，本文没有说明，相关文件比较多，大家可以自行搜索，一口君用的是File zilla；

通常这种需要长时间运行的程序，需要设置成守护进程，本文没有添加相应功能，读者可以自行搜索。如果强烈要求可以单开一篇详细介绍。
代码中time的管理函数，请读者自行搜索相关文章。
curl也提供了相关的函数库curl.lib，如果要实现更灵活的功能可以使用对应的api。
之所以先把文件拷贝成备份文件，主要是考虑其他模块随时可能修改日志文件，起到一定保护作用。

想和博主交流，请关注公众号「一口Linux」