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[/code]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