一、前言
在这篇文章中，我们使用composer的依赖包管理工具进行phpunit包安装和管理，composer官方地址https://getcomposer.org/，按照提示进行全局安装即可，另外，我们也会使用一个非常好用的Monolog记录日志组件记录日志，方便我们查看。
在根目录下建立coomposer.json的配置文件,输入以下内容:
{ "autoload":{ "classmap":[ "./" ] } } |
上面的意思是将根目录下的所有的类文件都加载进来，在命令行执行composerinstall后，在根目录会生成出一个vendor的文件夹，我们以后通过composer安装的任何第三方代码都会被生成在这里。
二、为什么要单元测试？
只要你想到输入一些东西到print语句或调试表达式中，就用测试代替它。--MartinFowler
PHPUnit是一个用PHP编程语言开发的开源软件，是一个单元测试框架。PHPUnit由SebastianBergmann创建，源于KentBeck的SUnit，是xUnit家族的框架之一。
单元测试是对单独的代码对象进行测试的过程，比如对函数、类、方法进行测试。单元测试可以使用任意一段已经写好的测试代码，也可以使用一些已经存在的测试框架，比如JUnit、PHPUnit或者Cantata++，单元测试框架提供了一系列共同、有用的功能来帮助人们编写自动化的检测单元，例如检查一个实际的值是否符合我们期望的值的断言。单元测试框架经常会包含每个测试的报告，以及给出你已经覆盖到的代码覆盖率。
总之一句话，使用phpunit进行自动测试，会使你的代码更健壮，减少后期维护的成本，也是一种比较标准的规范，现如今流行的PHP框架都带了单元测试，如Laraval,Symfony,Yii2等，单元测试已经成了标配。
三、安装PHPUnit
使用composer方式安装PHPUnit，其他安装方式请看这里
composerrequire--devphpunit/phpunit^6.2
安装Monolog日志包,做phpunit测试记录日志用。
composerrequiremonolog/monolog
安装好之后，我们可以看coomposer.json文件已经有这两个扩展包了：
"require":{ "monolog/monolog":"^1.23", }, "require-dev":{ "phpunit/phpunit":"^6.2" }, |
四、PHPUnit简单用法
1、单个文件测试
创建目录tests，新建文件StackTest.php，编辑如下：
<?php /** *1、composer安装Monolog日志扩展，安装phpunit单元测试扩展包 *2、引入autoload.php文件 *3、测试案例 * * */ namespaceApp\tests; require_once__DIR__.'/../vendor/autoload.php'; define("ROOT_PATH",dirname(__DIR__)."/"); useMonolog\Logger; useMonolog\Handler\StreamHandler; usePHPUnit\Framework\TestCase; classStackTestextendsTestCase { publicfunctiontestPushAndPop() { $stack=[]; $this->assertEquals(0,count($stack)); array_push($stack,'foo'); //添加日志文件,如果没有安装monolog，则有关monolog的代码都可以注释掉 $this->Log()->error('hello',$stack); $this->assertEquals('foo',$stack[count($stack)-1]); $this->assertEquals(1,count($stack)); $this->assertEquals('foo',array_pop($stack)); $this->assertEquals(0,count($stack)); } publicfunctionLog() { //createalogchannel $log=newLogger('Tester'); $log->pushHandler(newStreamHandler(ROOT_PATH.'storage/logs/app.log',Logger::WARNING)); $log->error("Error"); return$log; } } |
代码解释：
StackTest为测试类
StackTest继承于PHPUnit\Framework\TestCase
测试方法testPushAndPop()，测试方法必须为public权限，一般以test开头，或者你也可以选择给其加注释@test来表
在测试方法内，类似于assertEquals()这样的断言方法用来对实际值与预期值的匹配做出断言。
命令行执行:
phpunit命令测试文件命名
→framework#./vendor/bin/phpunittests/StackTest.php //或者可以省略文件后缀名 //./vendor/bin/phpunittests/StackTest |
执行结果：
→framework#./vendor/bin/phpunittests/StackTest.php PHPUnit6.4.1bySebastianBergmannandcontributors. .1/1(100%) Time:56ms,Memory:4.00MB OK(1test,5assertions) |
我们可以在app.log文件中查看我们打印的日志信息。
2、类文件引入
Calculator.php
<?php classCalculator { publicfunctionsum($a,$b) { return$a+$b; } } ?> |
单元测试类：
CalculatorTest.php
<?php namespaceApp\tests; require_once__DIR__.'/../vendor/autoload.php'; require"Calculator.php"; usePHPUnit\Framework\TestCase; classCalculatorTestextendsTestCase { publicfunctiontestSum() { $obj=newCalculator; $this->assertEquals(0,$obj->sum(0,0)); } } |
命令执行：
>./vendor/bin/phpunittests/CalculatorTest 执行结果： PHPUnit6.4.1bySebastianBergmannandcontributors. F1/1(100%) Time:117ms,Memory:4.00MB Therewas1failure: |
如果我们把这里的断言故意写错，$this->assertEquals(1,$obj->sum(0,0));
看执行结果：
PHPUnit6.4.1bySebastianBergmannandcontributors. F1/1(100%) Time:117ms,Memory:4.00MB Therewas1failure: 1)App\tests\CalculatorTest::testSum Failedassertingthat0matchesexpected1. /Applications/XAMPP/xamppfiles/htdocs/web/framework/tests/CalculatorTest.php:22 FAILURES! Tests:1,Assertions:1,Failures:1. |
会直接报出方法错误信息及行号，有助于我们快速找出bug
3、高级用法
你是否已经厌烦了在每一个测试方法命名前面加一个test，是否因为只是调用的参数不同，却要写多个测试用例而纠结？我最喜欢的高级功能，现在隆重推荐给你，叫做框架生成器。
Calculator.php
<?php classCalculator { publicfunctionsum($a,$b) { return$a+$b; } } ?> |
命令行启动测试用例，使用关键字--skeleton
>./vendor/bin/phpunit--skeletonCalculator.php
执行结果：
PHPUnit6.4.1bySebastianBergmannandcontributors. WrotetestclassskeletonforCalculatortoCalculatorTest.php. |
是不是很简单，因为没有测试数据，所以这里加测试数据，然后重新执行上边的命令
<?php classCalculator { /** *@assert(0,0)==0 *@assert(0,1)==1 *@assert(1,0)==1 *@assert(1,1)==2 */ publicfunctionsum($a,$b) { return$a+$b; } } ?> |
原始类中的每个方法都进行@assert注解的检测。这些被转变为测试代码，像这样
/** *Generatedfrom@assert(0,0)==0. */ publicfunctiontestSum(){ $obj=newCalculator; $this->assertEquals(0,$obj->sum(0,0)); } |
执行结果：
./vendor/bin/phpunittests/CalculatorTest PHPUnit6.4.1bySebastianBergmannandcontributors. .... Time:0seconds OK(4tests) |
4、其他用法
