第三章 Curl命令的使用

      ------phpunit 接口自动化测试系列

curl是利用URL语法在命令行方式下工作的开源文件传输工具。它被广泛应用在Unix、多种Linux发行版中，并且有DOS和Win32、Win64下的移植版本。这个命令功能非常强大，参数也比较多，所以不可能全部详细讲解的，我们只讲解一下常用的。

3.1 Get请求

   在接口测试过程中，对接口的Get请求是非常常用的。使用规则也很简单：直接把要请求的接口地址写到命令后面，如果接口有参数，则以“？param1=value&param2=value2”的形式传递给接口。

   例如：

$#>curl “http://api.zhongchou/login.php?username=xiaoming&password=123456”,

然后回车就可以返回接口的内容，我们查看一下返回结果，应该返回的信息都存在的话，则这个接口测试用例执行正确。

如果curl命令后面跟的不是接口地址，而是网站的地址，则会将网站的内容输出的屏幕上。

3.2 Post 请求

    第二种请求方式是post请求，这是第二种接口请求方式，其参数传递不像get请求直接把参数写到接口地址后面，需要用参数d将传递。如：

curl -d " userId=174107& Status=01&currType=CNY" http://ucfpay.wap.zhongchou.cn/callback-ucfnotice

当然，也可以把参数放到一个文件中，然后再传递给接口：

curl --data @filename https://github.api.com/authorizations

注：有些儿post接口需要登录信息，这些儿登录信息可能是接口读取cookie才能得到。我们调用接口的时候可以将token信息封装到头部中，然后再调用即可。

3.3 Cookies相关操作

  Cookies的重要性不言而遇了，有些儿时候我们需要cookie的相关操作。将cookie记录到文件中，那么使用命令：

curl -b stored_cookies_in_file www.cookiesite. com

curl可以根据旧的cookie写出新cookie并发送到网站：

curl -b cookies.txt -c newcookies.txt www.cookiesite. com

3.4 Curl下载

Curl可以实现下载页面或是文件的功能，方法一：使用linux的重定位功能>。例如：

curl http://www.centos.org>filename1

方法二：使用参数

-o：将文件保存为命令行中指定的文件名的文件中

-O：使用URL中默认的文件名保存文件到本地

# 将文件下载到本地并命名为mygettext.html

curl -o mygettext.html http://www.gnu.org/software/gettext/manual/gettext.html

# 将文件保存到本地并命名为gettext.html

curl -O http://www.gnu.org/software/gettext/manual/gettext.html

 

断点续传：

在文件下载过程中，如果出现了问题，再次下载后如果重新下载，会非常不爽的，这个时候大家就会想到，如果能断点续传就好了。当然curl命令有这个功能，就是参数c：

例如：

# 当文件在下载完成之前结束该进程

$ curl -O http://www.gnu.org/software/gettext/manual/gettext.html

##############             20.1%

# 通过添加-C选项继续对该文件进行下载，已经下载过的文件不会被重新下载

curl -C - -O http://www.gnu.org/software/gettext/manual/gettext.html

###############            21.1%

 

限速下载

通过--limit-rate选项对CURL的最大网络使用进行限制

# 下载速度最大不会超过1000B/second

 curl --limit-rate 1000B -O http://www.gnu.org/software/gettext/manual/gettext.html

 

下载指定时间内修改过的文件

 当下载一个文件时，可对该文件的最后修改日期进行判断，如果该文件在指定日期内修改过，就进行下载，否则不下载。

该功能可通过使用-z选项来实现：

# 若yy.html文件在2011/12/21之后有过更新才会进行下载

curl -z 21-Dec-11 http://www.example.com/yy.html

3.5 上传文件

上传的option是 -T

（1）向ftp传一个文件：

 curl -T localfile -u name:passwd ftp://upload_site:port/path/

（2）向http服务器上传文件：

curl -T localfile http://cgi2.tky.3web.ne.jp/~zzh/abc.cgi

3.6 CURL命令的其他参数

linux 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 <</SPAN>级别>启用与指定的安全级别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 用进度条显示当前的传送状态

3.7 PHP cURL 函数

PHP支持的由Daniel Stenberg创建的libcurl库允许你与各种的服务器使用各种类型的协议进行连接和通讯。

libcurl目前支持http、https、ftp、gopher、telnet、dict、file和ldap协议。libcurl同时也支持HTTPS认证、HTTP POST、HTTP PUT、 FTP 上传(这个也能通过PHP的FTP扩展完成)、HTTP 基于表单的上传、代理、cookies和用户名+密码的认证。

PHP中使用cURL实现Get和Post请求的方法这些函数在PHP 4.0.2中被引入。

以下包含了PHP cURL函数列表：

函数                      描述

curl_close()             关闭一个cURL会话。

curl_copy_handle()       复制一个cURL句柄和它的所有选项。

curl_errno()             返回最后一次的错误号。

curl_error()      返回一个保护当前会话最近一次错误的字符串。

curl_escape()     返回转义字符串，对给定的字符串进行URL编码。

curl_exec()              执行一个cURL会话。

curl_file_create()         创建一个 CURLFile 对象。

curl_getinfo()            获取一个cURL连接资源句柄的信息。

curl_init()               初始化一个cURL会话。

curl_multi_add_handle()   向curl批处理会话中添加单独的curl句柄。

curl_multi_close()         关闭一组cURL句柄。

curl_multi_exec()          运行当前 cURL 句柄的子连接。

curl_multi_getcontent()  如果设置了CURLOPT_RETURNTRANSFER，则返回获取的输出的文本流。

curl_multi_info_read()    获取当前解析的cURL的相关传输信息。

curl_multi_init()             返回一个新cURL批处理句柄。

curl_multi_remove_handle()   移除curl批处理句柄资源中的某个句柄资源。

curl_multi_select()         等待所有cURL批处理中的活动连接。

curl_multi_setopt()      设置一个批处理cURL传输选项。

curl_multi_strerror()    返回描述错误码的字符串文本。

curl_pause()             暂停及恢复连接。

curl_reset()             重置libcurl的会话句柄的所有选项。

curl_setopt_array()      为cURL传输会话批量设置选项。

curl_setopt()            设置一个cURL传输选项。

curl_share_close()       关闭cURL共享句柄。

curl_share_init()        初始化cURL共享句柄。

curl_share_setopt()      设置一个共享句柄的cURL传输选项。

curl_strerror()          返回错误代码的字符串描述。

curl_()          解码URL编码后的字符串。

curl_version()           获取cURL版本信息。

3.8 本章小结

 

   本章我们讲解了Curl命令常用的一些儿参数的用法，并列出了其他相关的参数，PHP操作Curl命令的函数等。通过本章的学习，我们需要掌握用Curl命令调用接口的方法，这相当于Web自动化测试的手工测试。如果我们连手工测试都不会执行，那怎么转化成对应的自动化测试呢？接下来我们讲解如何编写接口自动化测试用例，以及相同的技巧。