接口自动化测试工具

基于php的接口自动化测试工具；鉴于配置文件的局限性如果有更复杂的测试需求建议使用Mechanic, _(*1)

安装

程序采用composer安装，如果您没有安装composer请先安装composer，参考链接 composer官网，composer中文网在命令行或者终端执行, _(*2)

composer global require slince/runner *@dev

即可安装, _(*3)

runner采用json文件配置，支持的字段及解释见配置; 或者你可以拷贝样例文件到你的工作目录下;, _(*4)

打开控制台或者linux终端切换到你的工作目录，执行命令, _(*5)

runner

等待运行结束，可以查看工作目录下的report.xlsx文件查看接口测试结果, _(*6)

注意：如果提示您没有找到runner命令，您需要将composer全局bin目录加入到全局变量中去, _(*7)

设置代理，proxy 如果您的测试需要代理，或者您需要配合抓包工具比如charles或者fiddler抓包，那么您可以设置本参数，比如设置抓包代理 "proxy": "tcp://127.0.0.1:8888"，测试工具发出的请求与响应您都可以通过代理工具查看, _(*8)
自定义header，headers 自定义header比较容易实现，只要传递键值对即可，具体实例看参考文档, _(*9)
设置cookie,cookies cookies字段接受数组，每个数组元素是一个cookie对象，cookie对象支持的属性有name,value,expires,path和domian, _(*10)

"cookies": [
  {"name": "foo","value": "bar"}
]

cookie的支持是默认开启的，如果你想关闭cookie，需要设置enableCookie字段为false，同时也要从配置里移除cookies字段；因为如果使用cookies字段则意味着你需要cookie, _(*11)

一个接口的测试成功与否是通过断言实现的，runner支持三种断言，response、header和body断言, _(*12)

response断言，response仅仅是对响应状态码的判断，支持三个断言方法
- isOk 是否是200
- isNotFound 是否是404
- isXXX 魔术断言方法，xxx可以被任意自定义状态码取代
header断言，是对响应头的断言，支持的断言方法
- hasHeader 是否存在header
- headerEqual header值是否等于
- headerRegex header是否符合某个正则规则
- headerHasValues header是否有某些值，比如Accept-Language是否存在zh_CN， en_US
body断言，body是对响应内容的断言
- isJson 是否是合法的json响应
- isXMl 是否是xml响应
- hasParameter 是否存在某个参数
- hasParameters 是否存在某些参数
- parameterEqual 参数是否等于
- parameterRegex 参数是否符合某个正则规则

注意： 1. 关于json与xml的判断并不依赖响应头信息的Content-Type； 2. 如果需要参数断言方法判断的话，runner会优先将body转换成json去处理,如果body不是个合法的结构那么所有的参数判断都将无法通过； 3. 参数名支持层级获取，例, _(*13)

{
   path: {
      to: {
         foo:bar
      }
   }
}

你可以通过path.to.foo的形式去判断bar, _(*14)

25/07 2016

9999999-dev

Api Test Automation

Sources Download

Apache-2.0