PHP 行为测试工具 Codeception 介绍

Codeception 简介#

近年来 PHP 出现了三个很不错的 Test Framework , 分别是

• Phpspec 用过 Rails 的 rspec 的朋友应该会习惯这种写测试的方法;
• Behat 可读性最高的测试, 非程序员使用;
• Codeception 全堆栈的 PHP 测试框架, 提供测试的方法多样, 灵活.

这帖子我们来先介绍 Codeception.

Codeception 简单来说, 分为以下几种测试

• Acceptance Tests 验收测试
• Functional Tests 功能测试
• Unit Tests 单元测试

接下来我们来一一介绍每一种测试的优缺点.

Acceptance Tests 验收测试#

我们先设想这样一个场景：当技术人员开发完毕, 其客户, 产品经理, 或者是测试人员, 他们怎么确定产品的可用性? 一般情况下, 他们都是执行以下几个步骤进行测试:

• 打开浏览器;
• 输入 url;
• 看到一些信息, 并确定了这个页面是可用的;
• 点击某个 url;
• 填写表单, 并提交表单, 看到了某些信息, 并确定此功能是可用的

这种测试方式我们称之为 手动测试, 或 人工测试, 与其相反的是 自动化测试, Codeception 的 Acceptance Tests 会利用浏览器的编程接口, 做到以上的 人工测试 涉及到的步骤完全自动化, 大大节省了人工成本.

先贴代码

<?php
$I = new AcceptanceTester($scenario);
$I->amOnPage('/');
$I->click('Sign Up');
$I->submitForm('#signup', array('username' => 'MilesDavis', 'email' => 'miles@davis.com'));
$I->see('Thank you for Signing Up!');

优点#

• 可用来测试任何网站;
• 完全基于浏览器, 可以测试 Javascript 甚至是 ajax 请求;
• 可以把运行状态给 产品经理 或者 客户看, 让人信服;
• 不需要多余的配置, 对 App 源码修改要求最少, 代码适应性好, 可以当成整个应用来测试, 不在乎内部实现.

缺点#

• 测试速度缓慢, 因为需要运行在浏览器和真实的数据库上;
• 相比单元测试, 做不到完全的测试, 有些细微的逻辑可能会错过;
• 在运行的时候有时候会发生不可控的事情, 因为浏览器的渲染, javascript 的运行, 有时候会有意想不到的情况发生.
• 再一次强调, 此测试会非常慢;

Functional Tests 功能测试#

功能测试模拟一个 web 请求 (模拟 $_GET 和 $_POST 等变量), 发送给 App, 应用返回 HTML 结果, 在测试的过程中, 可以分析并进行 assert 判定返回的数据, 甚至可以检查数据是否正常的存储到数据库.

函数测试需要有一个测试环境, 几个有名的框架, 像 Laravel 就有现成的 Package 可以用来集成.

以下是一个简单的功能测试:

<?php
$I = new FunctionalTester($scenario);
$I->amOnPage('/');
$I->click('Sign Up');
$I->submitForm('#signup', array('username' => 'MilesDavis', 'email' => 'miles@davis.com'));
$I->see('Thank you for Signing Up!');
$I->seeEmailSent('miles@davis.com', 'Thank you for registration');
$I->seeInDatabase('users', array('email' => 'miles@davis.com'));

可以看出跟 Acceptance Tests 验收测试 语法类似, 因为集成了测试环境, 允许检查 email 和 数据库.

优点#

• 跟 Acceptance tests 类似, 但是少了打开浏览器来渲染, 速度快多了;
• 能提供更详细的分析, 如数据库或者 email;
• 可读性很强, 虽然没法让测试人员看到打开浏览器模拟人工测试, 但是还是可以让别人信服;
• 比较稳定, 只有当大规模的代码变更, 或者把代码从一个框架转移到另一个框架的时候, 才会有影响.

缺点#

• 无法测试 javascript 和 ajax;
• 因为使用代码相对简单的模拟一个浏览器请求, 测试的可行度, 或者说完整性, 会相对较差;
• 需要一个框架的支持;

Unit Tests 单元测试#

单元测试（又称为模块测试, Unit Testing）是针对程序模块（软件设计的最小单位）来进行正确性检验的测试工作, 当 functional 或者 acceptance 测试都检查不到 最小单位 的逻辑时, 还能通过 单元测试 确认深藏在代码里面的某些功能仍然可用, 单元测试能消除程序单元的不可靠性.

Codeception 的单元测试功能是基于 PHPUnit 之上的, 你可以照样写 PHPUnit 的测试代码, Codeception 一样能运行.

Codeception 在 PHPUnit 的基础上提供了一系列工具能让单元测试更加简单, 代码可读性更高. 单元测试是最复杂最繁琐的测试, 并且是会跟着业务逻辑代码的改变而改变, 在实际开发中技术人员会经常因为需求、业务的变更而修改单元测试, 提高其可读性和易用性可以帮助相关人员更加快速的跟上一切变化.

以下是一个简单的 integration test (集成测试)

<?php
function testSavingUser()
{
    $user = new User();
    $user->setName('Miles');
    $user->setSurname('Davis');
    $user->save();
    $this->assertEquals('Miles Davis', $user->getFullName());
    $this->unitTester->seeInDatabase('users',array('name' => 'Miles', 'surname' => 'Davis'));
}

优点#

• 最快的测试, 当然, 在上面的示例代码中, 触碰到了数据库, 还是有点延迟;
• 能把测试覆盖到特别刁钻的程序逻辑上, 这是 functional 或者 acceptance 所做不到的;
• 允许你测试最核心代码, 确定核心代码的健壮性;
• 写单元测试的程序要都是好程序员 

缺点#

• 因为是单元测试, 会把代码分为多个小单元单独测试, 但是各个单元之间的对接测试不到;

• 对代码的修改非常敏感, 很多项目的 test 最后没用上就是因为测试跟不上业务逻辑代码的修改.

Codeception API testing

下面是使用codecept进行API自动化测试的详细步骤：

简易的项目目录

www
|--tests
  
  
1
2
  
  
1
2

cd www
codecept bootstrap
codecept generate:suite api
codecept generate:cept api User
  
  
1
2
3
4
  
  
1
2
3
4

经过上面的操作以后，在 tests 目录下已经有了很多文件了，其中会有一些 api 相关的文件。

cat api.suite.yml 
# 配置文件

class_name: ApiTester
modules:
    enabled: [ApiHelper, PhpBrowser]
    config:
        PhpBrowser:
            url: http://httpbin.org
  
  
1
2
3
4
5
6
7
8
9
  
  
1
2
3
4
5
6
7
8
9

此时的目录信息，还有一些省略的文件

www
|--tests
|----api
|------_bootstrap.php
|------UserCept.php
  
  
1
2
3
4
5
  
  
1
2
3
4
5

编写 UserCept.PHP 来进行简单的测试

cat UserCept.php

<?php
$I = new ApiTester($scenario);
$I->wantTo('see my ip');
$I->amOnPage('/ip');
$I->seeResponseCodeIs(200);
$I->see('origin');
  
  
1
2
3
4
5
6
7
8
  
  
1
2
3
4
5
6
7
8

运行和查看测试结果

cd www
codecept build
codecept run api -v

转自：https://laravel-china.org/topics/25、http://blog.csdn.net/treesky/article/details/50172355