libcurl介绍

官方解释

CURL，全称Command Line URL Viewer，是一个Linux命令行工具，能从服务器下载数据，也能往服务器上发送数据，支持多种协议，支持的协议有：DICT，FILE，FTP，FTPS，GOPHER，HTTP，HTTPS，IMAP，IMAPS，LDAP，LDAPS，POP3，POP3S，RTMP，RTSP，SCP，SFTP，SMB，SMBS，SMTP，SMTPS，TELNET和TFTP。

Libcurl 和命令行

libcurl是它的c/cpp使用时的链接库，可以嵌入到你的项目中，这样你就有拥有了强大了网络功能，无需自己造轮子，常用的http get，post请求，http，ftp下载等都支持。

命令行工具则是方便用于直接使用curl的网络功能，无需二次开发，即可使用现成的功能，只要参数传对即可。

安装

最好的方式是从官方下载最新稳定版的进行编译，安装即可。

使用

嵌入到程序中：makefile 或者 cmake 需要设置好它的头文件，和库路径。(TODO)

命令行的使用方式：

# GET 直接通过URL传递数据
curl -u username https://api.github.com/user?access_token=XXXXXXXXXX
# POST --data/-d 方式指定使用POST方式传递数
curl -u username --data "param1=value1&param2=value" https://api.github.com
# 也可以指定一个文件，将该文件中的内容当作数据传递给服务器端
curl --data @filename https://github.api.com/authorizations
# 除了使用GET和POST协议外，还可以通过 -X 选项指定其它协议，如：
curl -I -X DELETE https://api.github.cim
# 如果想使用JSON形式post数据，可以使用-H指定头部类型
curl -H "Content-Type:application/json"

1.基本使用(get)

1
2
3

curl http://www.baidu.com
curl -o f1 ftp://user:pwd@myftp/Ricky/test.ini
curl dict://dict.org/d:test

2.post详细使用

curl -X POST \
  http://xxx.xxxx.cn/addOrder/ \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -H 'postman-token: 2f6b7816-cf06-f821-5658-7b6b3df82de2' \
  -d '{
    "batchNo": "Q331002322",
    "senderName": "posttest",
    "senderPhone": "18239934164",
    "senderAddress": "华尔街",
    "orderGoodsList":[{
            "goodsId":"1" ,
            "goodsName": "123222",
            "goodsPrice": 40,
            "goodsCount": 1
        }
    ],
    "deliverCompanyId": "566358",
    "deliverCompanyName": "京东",
    "sign": "zy"
}'

3.更多详细的命令行参数

-a/--append 上传文件时，附加到目标文件  
-A/--user-agent <string>  设置用户代理发送给服务器  
- anyauth   可以使用“任何”身份验证方法  
-b/--cookie <name=string/file> cookie字符串或文件读取位置  
- basic 使用HTTP基本验证  
-B/--use-ascii 使用ASCII /文本传输  
-c/--cookie-jar <file> 操作结束后把cookie写入到这个文件中  
-C/--continue-at <offset>  断点续转  
-d/--data <data>   HTTP POST方式传送数据  
--data-ascii <data>  以ascii的方式post数据  
--data-binary <data> 以二进制的方式post数据  
--negotiate     使用HTTP身份验证  
--digest        使用数字身份验证  
--disable-eprt  禁止使用EPRT或LPRT  
--disable-epsv  禁止使用EPSV  
-D/--dump-header <file> 把header信息写入到该文件中  
--egd-file <file> 为随机数据(SSL)设置EGD socket路径  
--tcp-nodelay   使用TCP_NODELAY选项  
-e/--referer 来源网址  
-E/--cert <cert[:passwd]> 客户端证书文件和密码 (SSL)  
--cert-type <type> 证书文件类型 (DER/PEM/ENG) (SSL)  
--key <key>     私钥文件名 (SSL)  
--key-type <type> 私钥文件类型 (DER/PEM/ENG) (SSL)  
--pass  <pass>  私钥密码 (SSL)  
--engine <eng>  加密引擎使用 (SSL). "--engine list" for list  
--cacert <file> CA证书 (SSL)  
--capath <directory> CA目录 (made using c_rehash) to verify peer against (SSL)  
--ciphers <list>  SSL密码  
--compressed    要求返回是压缩的形势 (using deflate or gzip)  
--connect-timeout <seconds> 设置最大请求时间  
--create-dirs   建立本地目录的目录层次结构  
--crlf          上传是把LF转变成CRLF  
-f/--fail          连接失败时不显示http错误  
--ftp-create-dirs 如果远程目录不存在，创建远程目录  
--ftp-method [multicwd/nocwd/singlecwd] 控制CWD的使用  
--ftp-pasv      使用 PASV/EPSV 代替端口  
--ftp-skip-pasv-ip 使用PASV的时候,忽略该IP地址  
--ftp-ssl       尝试用 SSL/TLS 来进行ftp数据传输  
--ftp-ssl-reqd  要求用 SSL/TLS 来进行ftp数据传输  
-F/--form <name=content> 模拟http表单提交数据  
-form-string <name=string> 模拟http表单提交数据  
-g/--globoff 禁用网址序列和范围使用{}和[]  
-G/--get 以get的方式来发送数据  
-h/--help 帮助  
-H/--header <line>自定义头信息传递给服务器  
--ignore-content-length  忽略的HTTP头信息的长度  
-i/--include 输出时包括protocol头信息  
-I/--head  只显示文档信息  
从文件中读取-j/--junk-session-cookies忽略会话Cookie  
- 界面<interface>指定网络接口/地址使用  
- krb4 <级别>启用与指定的安全级别krb4  
-j/--junk-session-cookies 读取文件进忽略session cookie  
--interface <interface> 使用指定网络接口/地址  
--krb4 <level>  使用指定安全级别的krb4  
-k/--insecure 允许不使用证书到SSL站点  
-K/--config  指定的配置文件读取  
-l/--list-only 列出ftp目录下的文件名称  
--limit-rate <rate> 设置传输速度  
--local-port<NUM> 强制使用本地端口号  
-m/--max-time <seconds> 设置最大传输时间  
--max-redirs <num> 设置最大读取的目录数  
--max-filesize <bytes> 设置最大下载的文件总量  
-M/--manual  显示全手动  
-n/--netrc 从netrc文件中读取用户名和密码  
--netrc-optional 使用 .netrc 或者 URL来覆盖-n  
--ntlm          使用 HTTP NTLM 身份验证  
-N/--no-buffer 禁用缓冲输出  
-o/--output 把输出写到该文件中  
-O/--remote-name 把输出写到该文件中，保留远程文件的文件名  
-p/--proxytunnel   使用HTTP代理  
--proxy-anyauth 选择任一代理身份验证方法  
--proxy-basic   在代理上使用基本身份验证  
--proxy-digest  在代理上使用数字身份验证  
--proxy-ntlm    在代理上使用ntlm身份验证  
-P/--ftp-port <address> 使用端口地址，而不是使用PASV  
-Q/--quote <cmd>文件传输前，发送命令到服务器  
-r/--range <range>检索来自HTTP/1.1或FTP服务器字节范围  
--range-file 读取（SSL）的随机文件  
-R/--remote-time   在本地生成文件时，保留远程文件时间  
--retry <num>   传输出现问题时，重试的次数  
--retry-delay <seconds>  传输出现问题时，设置重试间隔时间  
--retry-max-time <seconds> 传输出现问题时，设置最大重试时间  
-s/--silent静音模式。不输出任何东西  
-S/--show-error   显示错误  
--socks4 <host[:port]> 用socks4代理给定主机和端口  
--socks5 <host[:port]> 用socks5代理给定主机和端口  
--stderr <file>  
-t/--telnet-option <OPT=val> Telnet选项设置  
--trace <file>  对指定文件进行debug  
--trace-ascii <file> Like --跟踪但没有hex输出  
--trace-time    跟踪/详细输出时，添加时间戳  
-T/--upload-file <file> 上传文件  
--url <URL>     Spet URL to work with  
-u/--user <user[:password]>设置服务器的用户和密码  
-U/--proxy-user <user[:password]>设置代理用户名和密码  
-v/--verbose  
-V/--version 显示版本信息  
-w/--write-out [format]什么输出完成后  
-x/--proxy <host[:port]>在给定的端口上使用HTTP代理  
-X/--request <command>指定什么命令  
-y/--speed-time 放弃限速所要的时间。默认为30  
-Y/--speed-limit 停止传输速度的限制，速度时间'秒  
-z/--time-cond  传送时间设置  
-0/--http1.0  使用HTTP 1.0  
-1/--tlsv1  使用TLSv1（SSL）  
-2/--sslv2 使用SSLv2的（SSL）  
-3/--sslv3         使用的SSLv3（SSL）  
--3p-quote      like -Q for the source URL for 3rd party transfer  
--3p-url        使用url，进行第三方传送  
--3p-user       使用用户名和密码，进行第三方传送  
-4/--ipv4   使用IP4  
-6/--ipv6   使用IP6  
-#/--progress-bar 用进度条显示当前的传送状态