PHPUnit笔记
PHPUnit是一个面向PHP程序员的测试框架，这是一个xUnit的体系结构的单元测试框架。
复杂的项目，通过单元测试能够快速排查bug，有效减少bug的产生。简单的项目，使用php自带的var_dump()、print_r()也能很方便的调试bug。
PHPUnit通过运行测试用例里的断言（例如判断返回结果不为空），检查代码是否符合预期。
安装
安装方式有两种。一种是使用phar包，一种是使用Composer。
1、使用phar包
下载地址 https://phpunit.de/
有三个版本：
PHPUnit 6.4 支持PHP 7.0, 和 PHP 7.1。（Current Stable Release）
PHPUnit 5.7 支持 PHP 5.6, PHP 7.0, 和 PHP 7.1。（Old Stable Release）
PHPUnit 4.8 支持PHP 5.3~5.6。（No Longer Supported）
运行方法：
# 通用
php phpunit.phar --version
# linux
chmod +x phpunit.phar
sudo mv phpunit.phar /usr/local/bin/phpunit
phpunit --version
可以查看版本号。
2、使用Composer
如果用 Composer 来管理项目的依赖关系，只要在项目的composer.json 文件中简单地加上对 phpunit/phpunit 的依赖关系即可。下面是一个最小化的 composer.json 文件的例子，只定义了一个对 PHPUnit 5.7 的开发时依赖：
{
"require-dev": {
"phpunit/phpunit": "5.5.*"
}
}
要通过 Composer 完成系统级的安装，可以运行：
composer global require "phpunit/phpunit=5.5.*"
请确保 path 变量中包含有 ~/.composer/vendor/bin/。
配置PhpStorm使用PHPUnit
1、点击File->Settings->Languages & Frameworks，点击php，设置PHP开发环境：
2、点击php->PHPUnit，PHPUnit library里选中Path to phpunit.phar,指定路径，例如：D:\phpsetup\php\phpunit-5.7.4.phar：
编写第一个测试用例
1、新建文件夹Testcase，编写SayHello.php：
<?php
class SayHello{
public function printHello(){
echo 'Hello';
return 'Hello';
}
}
?>
2、新建测试用例SayHelloTest.php
<?php
require_once 'SayHello.php';
class SayHelloTest extends PHPUnit_Framework_TestCase {
public function setUp(){ }
public function tearDown(){ }
public function testConnectionIsValid(){
$hi = new SayHello();
$this->assertTrue($hi->printHello() == 'Hello');
}
}
编写完成后，切换到phpunit.phar所在目录命令行执行：
$ php phpunit.phar Testcase/SayHelloTest.php
输出结果：
PHPUnit 5.7.4 by Sebastian Bergmann and contributors.
. 1 / 1 (100%)Hello
Time: 130 ms, Memory: 10.00MB
OK (1 test, 1 assertion)
结果表明：
测试通过，1个测试方法，1个断言，没有失败。
这里注意的是：
1、所有以Test结尾的类均为测试用例；
2、所有以test开头的方法均是测试方法，会自动运行；
3、setUp是每个测试用例最先运行的方法，tearDown是每个测试用例最后运行的方法；
4、assertTrue用于判断结果是否为true。
如果用的PhpStorm，可以单击文件，右键Run SayHelloTest即可看到相同效果；也可以针对整个文件夹全部执行，选择文件夹Testcase右键Run Testcase即可。
ThinkPHP3.1集成PHPUnit
集成
需要修改的地方：
1、复制index.php为phpunit.php，内容增加：
define('APP_PHPUNIT', true);
示例：
<?php
define('APP_DEBUG', true);
header("Content-type: text/html; charset=utf-8");
//define('APP_PATH', './');
define('APP_PATH', __DIR__ .'/');
define('APP_PHPUNIT', true);
require APP_PATH .'Core/ThinkPHP.php';
?>
需要使用绝对路径。
2、修改ThinkPHP/Lib/Core/App.class.php：
将run()方法里App::exec()改为：
(APP_PHPUNIT !== true) && App::exec();//支持phpunit
3、ThinkPHP/Core/Lib/Core/增加AjaxReturnEvent.class.php:
<?php
class AjaxReturnEvent extends Exception {
}
4、修改ThinkPHP/Common/runtime.php:
将2处
CORE_PATH.'Core/Think.class.php',
CORE_PATH.'Core/ThinkException.class.php', // 异常处理类
CORE_PATH.'Core/Behavior.class.php',
改为：
CORE_PATH.'Core/Think.class.php',
CORE_PATH.'Core/ThinkException.class.php', // 异常处理类
CORE_PATH.'Core/Behavior.class.php',
CORE_PATH.'Core/AjaxReturnEvent.class.php',
记得是2处。load_runtime_file和build_runtime_cache方法都要修改。
5、修改ThinkPHP/Lib/Core/Action.class.php里ajaxReturn方法：
switch (strtoupper($type)){
case 'JSON' :
// 返回JSON数据格式到客户端 包含状态信息
header('Content-Type:application/json; charset=utf-8');
if(APP_PHPUNIT === true){throw new AjaxReturnEvent(json_encode($data)); return;}//以支持phpunit捕获结果
exit(json_encode($data));
case 'XML' :
// 返回xml格式数据
header('Content-Type:text/xml; charset=utf-8');
if(APP_PHPUNIT === true){throw new AjaxReturnEvent(xml_encode($data)); return;}//以支持phpunit捕获结果
exit(xml_encode($data));
case 'JSONP':
// 返回JSON数据格式到客户端 包含状态信息
header('Content-Type:application/json; charset=utf-8');
$handler = isset($_GET[C('VAR_JSONP_HANDLER')]) ? $_GET[C('VAR_JSONP_HANDLER')] : C('DEFAULT_JSONP_HANDLER');
if(APP_PHPUNIT === true){throw new AjaxReturnEvent($handler.'('.json_encode($data).');'); return;}//以支持phpunit捕获结果
exit($handler.'('.json_encode($data).');');
case 'EVAL' :
// 返回可执行的js脚本
header('Content-Type:text/html; charset=utf-8');
if(APP_PHPUNIT === true){throw new AjaxReturnEvent($data); return;}//以支持phpunit捕获结果
exit($data);
default :
// 用于扩展其他返回格式数据
tag('ajax_return',$data);
}
主要做了2件事情：
1、支持phpunit测试模式；
2、防止ajaxReturn里的exit结束了程序。
示例
目录结构（示例程序采用了模块分组）：
--example
|--Common
|--Conf
|--ThinkPHP
|--Lib
|--Action
| |--Weixin
| |--Api
| |--UserAction.class.php
|--Model
|--Runtime
|--Testcase
|--Weixin
|--Api
|--UserAction.class.php
|--Tpl
|--vendor
|--index.php
|--phpunit.php
1、Model测试
<?php
define('TEST_PATH', dirname(dirname(__FILE__)));
require TEST_PATH .'/../phpunit.php';
class OrderTest extends PHPUnit_Framework_TestCase {
public function testGetBillRule(){
$order_model = D('Orders');
$this->assertTrue(is_object($order_model) == true);
$this->assertNotEmpty($order_model->getBillRule());
}
}
2、Api测试
<?php
define('TEST_APP', 'Api');
define('TEST_PATH', dirname(dirname(__FILE__)));
require TEST_PATH .'/../phpunit.php';
class OrderTest extends PHPUnit_Framework_TestCase {
public function setUp() {
//自动加载
spl_autoload_register (function ( $class ) {
include APP_PATH . 'Lib/Action/'.TEST_APP.'/' . $class . '.class.php' ;
});
}
public function tearDown(){
}
public function testModule(){
$obj = new OrderAction();
$this->assertTrue(is_array($obj->getBillRule()) == true);
}
public function testApi(){
try{
$obj = new OrderAction();
$obj->getBillRule(); //由于TP里的ajaxReturn会使用exit结束程序，这里使用异常来得到返回的内容
}catch(AjaxReturnEvent $e){
$res = json_decode($e->getMessage(), treu);
$this->assertNotEmpty($res);
}
}
}
参考
1、开始使用 PHPUnit – PHP测试框架
http://phpunit.cn/getting-started.html
2、web3d/TPUnit: ThinkPHP PHPUnit框架集成
https://github.com/web3d/TPUnit/
3、[PHP]PHPUnit安装配置及样例 | CoinIdea的技术分享博客
http://blog.coinidea.com/web开发/php-1088.html
4、《xUnit Test Patterns》学习笔记系列 - CoderZh - 博客园
http://www.cnblogs.com/coderzh/archive/2010/01/23/xUnit-Test-Patterns.html
（未完待续）
本文优先在公众号"飞鸿影的博客(fhyblog)"发布，欢迎关注公众号及时获取最新文章推送！
作者：飞鸿影
出处：http://52fhy.cnblogs.com/
版权申明：没有标明转载或特殊申明均为作者原创。本文采用以下协议进行授权,自由转载 - 非商用 - 非衍生 - 保持署名 | Creative Commons BY-NC-ND 3.0，转载请注明作者及出处。
