第四章接口自动化测试用例详解(上)

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

经过前三章的学习，我们准备好了对接口进行自动化测试的相关知识。现在我们开始讲解接口自动化测试用例的编写。在本章编写的测试用例中，我们只针对具体的接口，编写自动化测试用例，而不对代码架构进行规划，那些儿进阶性的知识点，我们将在后面的章节讲解。先学习如何砌砖，然后我们再去建自己的高楼大厦。

4.1 Get方式接口自动化用例

Get方式的接口自动化相对来说比较简单，直接调用接口地址，把参数放到接口地址后面即可。下面我们以众筹网的接口实例来讲解：

（1）接口文档

按关键字搜索项目（GET）：

URL：http://api.zhongchou.cn/deal/list

参数：

keyword，搜索关键字

offset，拉取偏移，非必需，默认为0

count，拉取个数，非必需，默认为10

返回：项目Feed基础数据结构的数组

上面是一个搜索项目的接口文档，从文档中我们得知，这个接口是Get方式的，而且有三个参数，第一个参数是必需的，后两个参数是非必需的。返回值是Feed基础数据结构的数据（暂不要理会）。

（2）Curl命令调用

为了安全期间，我们调用测试环境下的数据，先绑定host: xx.xx.xx.xx api.zhongchou.cn。然后在终端下执行下面的命令：

[root@n028 api]# curl http://api.zhongchou.cn/deal/list?v=1&keyword='测试'

执行结果如图4.1.1所示：

　　　　　　　　　　　　　　　　图4.1.1 Curl调用接口返回值

当然，上面在终端下的接口返回的结果是加密后的json字符串，不太容易看明白。

（3）浏览器访问接口

为了使用接口返回值更加清晰明了，我们要借助于一个浏览器插件JsonView。此插件可以直接解析接口返回的json字符串，方便明了，不过有个缺点：只能查看Get方式的接口。

针对上面的例子，我们直接在浏览器的地址栏中输入http://api.zhongchou.cn/deal/list?v=1&keyword='测试'，然后回车，就可以看到如图4.1.2所示：

       图4.1.2浏览器访问接口

这样访问接口，返回值是不是更加清晰了。对应返回值中包含的汉字也作了对应的解码。

（4）PHP调用Get方式接口

PHP对接口的调用有完整的一套函数，对于Get方式的接口，只需要调用函数file_get_contents（）就能得到返回值。

示例代码如下：

class Demo extends PHPUnit_Framework_TestCase{

    public function testSearch()

    {

        $url="http://api.zhongchou.cn/deal/list?keyword=测试&v=1";

        $ret=file_get_contents($url);

        echo $ret;

    }

}

在JetBrains PhpStorm执行结果如图4.1.3所示：

图4.1.3 PHP调用Get接口执行结果

这个结果和在终端下调用Curl命令结果是一样的，那有没有和浏览器下结果那样的呢？当然有了，因为这个接口返回值是json编码过的，我们调用函数json_decode（）解码一下即可。解码后的结果见图4.1.4所示：

图4.1.4 对接口返回值进行解码输出

（5）PHP编写Get接口自动化测试用例

经过上面的四步分析，我们已经可以用php来调用接口了，可是这还不是完整的自动化测试用例。我们需要添加对返回结果的验证，如果和预期的一样，就成功，如果不一样就失败。

完整的测试用例：

class Demo extends PHPUnit_Framework_TestCase{

    public function testSearch()

{

 

        $url="http://api.zhongchou.cn/deal/list?keyword=测试&v=1";

        $ch = curl_init();

        curl_setopt($ch, CURLOPT_URL, $url);

        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

        curl_setopt($ch, CURLOPT_HEADER, 0);

        $ret=curl_exec($ch);

        curl_close($ch);

        $data=json_decode($ret,true);

        //print_r($data);

        if(is_null($data)==false)

        {

            if($data['errno']=='0')

            {

                $this->assertEquals('0',$data['errno']);//判断errno是否为0，此步为抛出执行通过

                $index =strpos($data['data'][0]['name'],'测试');

                $this->assertnotEquals(-1,$index);//判断结果是否包含关键字

                print('接口/deal/list：搜索接口------------------OK'.'\n');

            }

            else

            {

                $this->assertEquals('0',$data['errno']);//抛出执行失败

                print("接口/deal/list：搜索接口---------------Failure!"."\n".$ret."\n");

            }

        }

 

    }

}

我们为了判断结果，没有调用file_get_contents（）函数，而改用了PHP调用接口的通用方法，如果不理解可以去网上查找相关讲解。而后我们加入了对接口返回值$data的判断：判断errno是否为0，查询结果中有没有包含关键字等。对于检测点的设置技巧，我们将在后面进阶篇中讲解。

结过这样的测试用例代码，我们就可以执行测试用例了，并且测试用例会自己判断接口调用的结果。执行结果如图4.1.5所示，如果想查看接口的具体返回值，只需要取消//print_r($data);此句的注释即可。

图4.1.5 Get接口的执行结果

第四章 接口自动化测试用例详解(上)

4.1 Get方式接口自动化用例

推荐阅读

第四章接口自动化测试用例详解(上)