php think unit,GitHub - gaoermai/ThinkPHPUnit: 在ThinkPHP上使用PHPUnit

ThinkPHPUnit

在ThinkPHP开源框架上，使用PHPUnit作为测试框架。

##安装和样例代码

###安装方法

shell> cd /path/to/thinkphp/app/Lib/ORG/

shell> git clone https://github.com/gaoermai/ThinkPHPUnit.git

###创建TestAction

在 /path/to/thinkphp/app/Lib/Action 下(如有分组请自行决定放在哪个分组下，或者可以创建一个专门的test分组)，创建 TestAction.class.php ，代码如下：

import('@.ORG.ThinkPHPUnit.ThinkPHPUnitAction');

class TestAction extends ThinkPHPUnitAction {

protected $_message_render = self::MESSAGE_RENDER_ECHO;

protected function _testExample() {

$this->assertLessThan(1, 2, '可以使用中文作为错误提示');

$this->assertLessThan(2, 1);

$this->assertContainsOnly('string', array('1', '2', 3));

}

}

访问 http://example.com/thinkphpunit/test (注意：无需把URL指向特定的方法)，如果一切顺利的话，就可以看到下面提示：

[Failure]: 可以使用中文作为错误提示

Failed asserting that 2 is less than 1.

CLASS: TestAction

METHOD: testExample

LINE: 10

[Failure]: Failed asserting that Array (

0 => '1'

1 => '2'

2 => 3

) contains only values of type "string".

CLASS: TestAction

METHOD: testExample

LINE: 12

##使用帮助

###创建测试用例Action

ThinkPHPUnit需要独立的Action文件，继承ThinkPHPUnitAction类。

类似这样：

class TestAction extends ThinkPHPUnitAction {}

类中的方法，只有类似 public testFuncName() 或者 protected _testFuncName() 这样命名的，才会被认为是包含测试用例的测试方法。 ThinkPHPUnitAction::index() 能够自动地逐一执行这些方法并返回结果。

###使用哪种断言错误记录方式

定义记录错误的方式使用下面代码：

class TestAction extends ThinkPHPUnitAction {

protected $_message_render = self::MESSAGE_RENDER_ECHO;

}

ThinkPHPUnit支持4种断言错误输出常量：

ThinkPHPUnitAction::MESSAGE_RENDER_EXCEPTION：断言错误时以使用抛出异常(默认)

ThinkPHPUnitAction::MESSAGE_RENDER_ERROR_LOG：断言错误时以PHP日志方式记录错误

ThinkPHPUnitAction::MESSAGE_RENDER_VARDUMP：断言错误时以使用var_dump()函数输出

ThinkPHPUnitAction::MESSAGE_RENDER_ECHO：断言错误时以使用文本输出方式(推荐)

在测试环境中，推荐使用 ThinkPHPUnitAction::MESSAGE_RENDER_ECHO 方式输出错误。

如果是生产环境，那么建议：

如果有安全屏蔽测试用的Action，那么仍然可以采用 ThinkPHPUnitAction::MESSAGE_RENDER_ECHO 方式；

如果没有，那么建议采用 ThinkPHPUnitAction::MESSAGE_RENDER_ERROR_LOG 。

###如何测试异常？

在PHPUnit的官方文档中，有描述通过类似下面的注释代码来测试异常：

class ExceptionTest extends PHPUnit_Framework_TestCase

{

/**

* @expectedException InvalidArgumentException

*/

public function testException()

{

}

}

但是，在Web环境中，是没有办法通过注释标注的方式来测试异常的。从ThinkPHPUnit v0.2版本开始，提供了新的方法来对异常进行输出：

protected function _testException() {

try {

throw new InvalidArgumentException();

}catch (InvalidArgumentException) {

}catch (Exception $e) {

$this->render_exception($e);

}

}

使用这种方法，可以输出预期异常并输出。

###生产环境部署须知

在生产环境中，为了限制普通用户访问测试用例，可以采用以下几种安全措施。

####设置HTTP Authentication

HTTP Authentication是一种HTTP基础的用户名密码验证方式。从ThinkPHPUnit v0.2版本开始，内置了这种验证方式。配置方法：

class TestAction extends ThinkPHPUnitAction {

protected $_http_auth_username = 'YOUR USERNAME HERE';

protected $_http_auth_password = 'YOUR PASSWORD HERE';

}

为安全起见，建议将用户名和密码都设置成超过16位的大小写数字混合的字符串形式。

默认的，当常量 APP_DEBUG 为true时，HTTP验证不开启。

####采用随机的Action名

不采用常见的如 TestAction 这样的名称，能够有效的避免非法用户猜测测试用例的网址。

####在Web服务器上限定IP等措施

更加安全的做法，可以在Web服务(如Apache、Nginx)上，对测试用例所在的网址进行IP过滤等。这些方法属于Web服务的讨论范围，请阅读相关文档。