curl使用

背景

从curl的一个使用实例说起：
将以下代码拷贝到命令行即可执行

curl -X POST \
  http://jd.dev.imdada.cn/pickup/addOrder/ \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -H 'postman-token: 2f6b7816-cf06-f821-5658-7b6b3df82de2' \
  -d '{
    "batchNo": "Q33100223333",
    "senderName": "上门揽件",
    "senderPhone": "18239922164",
    "senderAddress": "上海浦东新区隆宇大厦浦东南路1036",
    "orderGoodsList":[{
            "goodsId":"1" ,
            "goodsName": "123222",
            "goodsPrice": 40,
            "goodsCount": 1
        }
    ],
    "deliverCompanyId": "566358",
    "deliverCompanyName": "华北众包站",
    "sign": "zy"
}'

这是因为mac或者windows中预装了curl命令行工具。那么curl是什么呢？哪里有用到。

CURL介绍

官方解释

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。

深入理解

curl是一个广泛使用的用来上传和下载的命令行工具，当然严格来讲，它还可以有别的用途。对于测试来讲，它是Web相关测试非常实用的工具，包括debugging，使用起来非常方便。而且另一方面，因为它是纯命令行的工具，所以也可以非常方便的作为一个组件集成到automation或者其他的测试框架里面，将HTTP/HTTPS/FTP相关的上传和下载等任务交给它。
最近因为在做web service相关的测试，用到了curl，觉得还不错，顺便给大家介绍一下。

使用方法

基本用法示例

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

传递请求数据

默认curl使用GET方式请求数据，这种方式下直接通过URL传递数据
可以通过 --data/-d 方式指定使用POST方式传递数据

# GET
curl -u username https://api.github.com/user?access_token=XXXXXXXXXX

# POST
curl -u username --data "param1=value1¶m2=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"

总结

CURL的命令参数还有很多，就不一一演示了。下面是CURL的参数及功能列表：

-a/--append 上传文件时，附加到目标文件  
 -A/--user-agent   设置用户代理发送给服务器  
 - anyauth   可以使用“任何”身份验证方法  
 -b/--cookie  cookie字符串或文件读取位置  
 - basic 使用HTTP基本验证  
 -B/--use-ascii 使用ASCII /文本传输  
 -c/--cookie-jar  操作结束后把cookie写入到这个文件中  
 -C/--continue-at   断点续转  
 -d/--data    HTTP POST方式传送数据  
 --data-ascii   以ascii的方式post数据  
 --data-binary  以二进制的方式post数据  
 --negotiate     使用HTTP身份验证  
 --digest        使用数字身份验证  
 --disable-eprt  禁止使用EPRT或LPRT  
 --disable-epsv  禁止使用EPSV  
 -D/--dump-header  把header信息写入到该文件中  
 --egd-file  为随机数据(SSL)设置EGD socket路径  
 --tcp-nodelay   使用TCP_NODELAY选项  
 -e/--referer 来源网址  
 -E/--cert  客户端证书文件和密码 (SSL)  
 --cert-type  证书文件类型 (DER/PEM/ENG) (SSL)  
 --key      私钥文件名 (SSL)  
 --key-type  私钥文件类型 (DER/PEM/ENG) (SSL)  
 --pass    私钥密码 (SSL)  
 --engine   加密引擎使用 (SSL). "--engine list" for list  
 --cacert  CA证书 (SSL)  
 --capath  CA目录 (made using c_rehash) to verify peer against (SSL)  
 --ciphers   SSL密码  
 --compressed    要求返回是压缩的形势 (using deflate or gzip)  
 --connect-timeout  设置最大请求时间  
 --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  模拟http表单提交数据  
 -form-string  模拟http表单提交数据  
 -g/--globoff 禁用网址序列和范围使用{}和[]  
 -G/--get 以get的方式来发送数据  
 -h/--help 帮助  
 -H/--header 自定义头信息传递给服务器  
 --ignore-content-length  忽略的HTTP头信息的长度  
 -i/--include 输出时包括protocol头信息  
 -I/--head  只显示文档信息  
 从文件中读取-j/--junk-session-cookies忽略会话Cookie  
 - 界面指定网络接口/地址使用  
 - krb4 <级别>启用与指定的安全级别krb4  
 -j/--junk-session-cookies 读取文件进忽略session cookie  
 --interface  使用指定网络接口/地址  
 --krb4   使用指定安全级别的krb4  
 -k/--insecure 允许不使用证书到SSL站点  
 -K/--config  指定的配置文件读取  
 -l/--list-only 列出ftp目录下的文件名称  
 --limit-rate  设置传输速度  
 --local-port 强制使用本地端口号  
 -m/--max-time  设置最大传输时间  
 --max-redirs  设置最大读取的目录数  
 --max-filesize  设置最大下载的文件总量  
 -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 
 使用端口地址，而不是使用PASV  
 -Q/--quote 文件传输前，发送命令到服务器  
 -r/--range 检索来自HTTP/1.1或FTP服务器字节范围  
 --range-file 读取（SSL）的随机文件  
 -R/--remote-time   在本地生成文件时，保留远程文件时间  
 --retry    传输出现问题时，重试的次数  
 --retry-delay   传输出现问题时，设置重试间隔时间  
 --retry-max-time  传输出现问题时，设置最大重试时间  
 -s/--silent静音模式。不输出任何东西  
 -S/--show-error   显示错误  
 --socks4  用socks4代理给定主机和端口  
 --socks5  用socks5代理给定主机和端口  
 --stderr   
 -t/--telnet-option  Telnet选项设置  
 --trace   对指定文件进行debug  
 --trace-ascii  Like --跟踪但没有hex输出  
 --trace-time    跟踪/详细输出时，添加时间戳  
 -T/--upload-file  上传文件  
 --url      Spet URL to work with  
 -u/--user 设置服务器的用户和密码  
 -U/--proxy-user 设置代理用户名和密码  
 -v/--verbose  
 -V/--version 显示版本信息  
 -w/--write-out [format]什么输出完成后  
 -x/--proxy 在给定的端口上使用HTTP代理  
 -X/--request 指定什么命令  
 -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 用进度条显示当前的传送状态

参考

源码阅读第二期之curl-7.22.0