本文實(shí)例講述了PHP單元測(cè)試框架PHPUnit用法。分享給大家供大家參考，具體如下：

以前在學(xué)習(xí)IOS開發(fā)時(shí)有專門寫過(guò)Objective-C的單元測(cè)試的文章，IOS開發(fā)學(xué)習(xí)之單元測(cè)試，今天再總結(jié)下怎么在PHP中使用單元測(cè)試。

一、前言

在這篇文章中，我們使用 composer 的依賴包管理工具進(jìn)行phpunit包安裝和管理，composer 官方地址 https://getcomposer.org/，按照提示進(jìn)行全局安裝即可，另外，我們也會(huì)使用一個(gè)非常好用的Monolog記錄日志組件記錄日志，方便我們查看。

在根目錄下建立 coomposer.json 的配置文件,輸入以下內(nèi)容:

{
  "autoload": {
    "classmap": [
      "./"
    ]
  }
}

上面的意思是將根目錄下的所有的類文件都加載進(jìn)來(lái)， 在命令行執(zhí)行 composer install 后，在根目錄會(huì)生成出一個(gè)vendor的文件夾，我們以后通過(guò) composer 安裝的任何第三方代碼都會(huì)被生成在這里。

二、為什么要單元測(cè)試？

只要你想到輸入一些東西到print語(yǔ)句或調(diào)試表達(dá)式中，就用測(cè)試代替它。 --Martin Fowler

PHPUnit 是一個(gè)用PHP編程語(yǔ)言開發(fā)的開源軟件，是一個(gè)單元測(cè)試框架。PHPUnit由Sebastian Bergmann創(chuàng)建，源于Kent Beck的SUnit，是xUnit家族的框架之一。

單元測(cè)試是對(duì)單獨(dú)的代碼對(duì)象進(jìn)行測(cè)試的過(guò)程，比如對(duì)函數(shù)、類、方法進(jìn)行測(cè)試。單元測(cè)試可以使用任意一段已經(jīng)寫好的測(cè)試代碼，也可以使用一些已經(jīng)存在的測(cè)試框架，比如JUnit、PHPUnit或者Cantata++，單元測(cè)試框架提供了一系列共同、有用的功能來(lái)幫助人們編寫自動(dòng)化的檢測(cè)單元，例如檢查一個(gè)實(shí)際的值是否符合我們期望的值的斷言。單元測(cè)試框架經(jīng)常會(huì)包含每個(gè)測(cè)試的報(bào)告，以及給出你已經(jīng)覆蓋到的代碼覆蓋率。

總之一句話，使用 phpunit 進(jìn)行自動(dòng)測(cè)試，會(huì)使你的代碼更健壯，減少后期維護(hù)的成本，也是一種比較標(biāo)準(zhǔn)的規(guī)范，現(xiàn)如今流行的PHP框架都帶了單元測(cè)試，如Laraval,Symfony,Yii2等，單元測(cè)試已經(jīng)成了標(biāo)配。

另外，單元測(cè)試用例是通過(guò)命令操控測(cè)試腳本的，而不是通過(guò)瀏覽器訪問(wèn)URL的。

三、安裝PHPUnit

使用 composer 方式安裝 PHPUnit，其他安裝方式請(qǐng)看這里

composer require --dev phpunit/phpunit ^6.2

安裝 Monolog 日志包,做 phpunit 測(cè)試記錄日志用。

composer require monolog/monolog

安裝好之后，我們可以看coomposer.json 文件已經(jīng)有這兩個(gè)擴(kuò)展包了：

"require": {
  "monolog/monolog": "^1.23",
  },
"require-dev": {
    "phpunit/phpunit": "^6.2"
  },

四、PHPUnit簡(jiǎn)單用法

1、單個(gè)文件測(cè)試

創(chuàng)建目錄tests，新建文件 StackTest.php，編輯如下：

?php
/**
 * 1、composer 安裝Monolog日志擴(kuò)展，安裝phpunit單元測(cè)試擴(kuò)展包
 * 2、引入autoload.php文件
 * 3、測(cè)試案例
 *
 *
 */
namespace App\tests;
require_once __DIR__ . '/../vendor/autoload.php';
define("ROOT_PATH", dirname(__DIR__) . "/");
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use PHPUnit\Framework\TestCase;
class StackTest extends TestCase
{
  public function testPushAndPop()
  {
    $stack = [];
    $this->assertEquals(0, count($stack));
    array_push($stack, 'foo');
    // 添加日志文件,如果沒(méi)有安裝monolog，則有關(guān)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));
  }
  public function Log()
  {
    // create a log channel
    $log = new Logger('Tester');
    $log->pushHandler(new StreamHandler(ROOT_PATH . 'storage/logs/app.log', Logger::WARNING));
    $log->error("Error");
    return $log;
  }
}

代碼解釋：

StackTest為測(cè)試類

StackTest 繼承于 PHPUnit\Framework\TestCase

測(cè)試方法testPushAndPop()，測(cè)試方法必須為public權(quán)限，一般以test開頭，或者你也可以選擇給其加注釋@test來(lái)表

在測(cè)試方法內(nèi)，類似于 assertEquals() 這樣的斷言方法用來(lái)對(duì)實(shí)際值與預(yù)期值的匹配做出斷言。

命令行執(zhí)行:

phpunit 命令 測(cè)試文件命名

➜ framework# ./vendor/bin/phpunit tests/StackTest.php
// 或者可以省略文件后綴名
// ./vendor/bin/phpunit tests/StackTest

執(zhí)行結(jié)果：

➜  framework# ./vendor/bin/phpunit tests/StackTest.php
PHPUnit 6.4.1 by Sebastian Bergmann and contributors.
.                                                                   1 / 1 (100%)
Time: 56 ms, Memory: 4.00MB
OK (1 test, 5 assertions)

我們可以在app.log文件中查看我們打印的日志信息。

2、類文件引入

Calculator.php

?php
class Calculator
{
  public function sum($a, $b)
  {
    return $a + $b;
  }
}
?>

單元測(cè)試類：

CalculatorTest.php

?php
namespace App\tests;
require_once __DIR__ . '/../vendor/autoload.php';
require "Calculator.php";
use PHPUnit\Framework\TestCase;
class CalculatorTest extends TestCase
{
  public function testSum()
  {
    $obj = new Calculator;
    $this->assertEquals(0, $obj->sum(0, 0));
  }
}

命令執(zhí)行：

> ./vendor/bin/phpunit tests/CalculatorTest

執(zhí)行結(jié)果：

PHPUnit 6.4.1 by Sebastian Bergmann and contributors.
F                                                                   1 / 1 (100%)
Time: 117 ms, Memory: 4.00MB
There was 1 failure:

如果我們把這里的斷言故意寫錯(cuò)，$this->assertEquals(1, $obj->sum(0, 0));

看執(zhí)行結(jié)果：

PHPUnit 6.4.1 by Sebastian Bergmann and contributors.
F                                                                   1 / 1 (100%)
Time: 117 ms, Memory: 4.00MB
There was 1 failure:
1) App\tests\CalculatorTest::testSum
Failed asserting that 0 matches expected 1.
/Applications/XAMPP/xamppfiles/htdocs/web/framework/tests/CalculatorTest.php:22
FAILURES!
Tests: 1, Assertions: 1, Failures: 1.

會(huì)直接報(bào)出方法錯(cuò)誤信息及行號(hào)，有助于我們快速找出bug

3、高級(jí)用法

你是否已經(jīng)厭煩了在每一個(gè)測(cè)試方法命名前面加一個(gè)test，是否因?yàn)橹皇钦{(diào)用的參數(shù)不同，卻要寫多個(gè)測(cè)試用例而糾結(jié)？我最喜歡的高級(jí)功能，現(xiàn)在隆重推薦給你，叫做框架生成器。

Calculator.php

?php
class Calculator
{
  public function sum($a, $b)
  {
    return $a + $b;
  }
}
?>

命令行啟動(dòng)測(cè)試用例，使用關(guān)鍵字 --skeleton

> ./vendor/bin/phpunit --skeleton Calculator.php

執(zhí)行結(jié)果：

PHPUnit 6.4.1 by Sebastian Bergmann and contributors.
Wrote test class skeleton for Calculator to CalculatorTest.php.

是不是很簡(jiǎn)單，因?yàn)闆](méi)有測(cè)試數(shù)據(jù)，所以這里加測(cè)試數(shù)據(jù)，然后重新執(zhí)行上邊的命令

?php
class Calculator
{
  /**
   * @assert (0, 0) == 0
   * @assert (0, 1) == 1
   * @assert (1, 0) == 1
   * @assert (1, 1) == 2
   */
  public function sum($a, $b)
  {
    return $a + $b;
  }
}
?>

原始類中的每個(gè)方法都進(jìn)行@assert注解的檢測(cè)。這些被轉(zhuǎn)變?yōu)闇y(cè)試代碼，像這樣

/**
 * Generated from @assert (0, 0) == 0.
 */
public function testSum() {
  $obj = new Calculator;
  $this->assertEquals(0, $obj->sum(0, 0));
}

執(zhí)行結(jié)果：

./vendor/bin/phpunit tests/CalculatorTest
PHPUnit 6.4.1 by Sebastian Bergmann and contributors.
....
Time: 0 seconds
OK (4 tests)

更多關(guān)于PHP相關(guān)內(nèi)容感興趣的讀者可查看本站專題：《PHP錯(cuò)誤與異常處理方法總結(jié)》、《php字符串(string)用法總結(jié)》、《PHP數(shù)組(Array)操作技巧大全》、《PHP運(yùn)算與運(yùn)算符用法總結(jié)》、《PHP網(wǎng)絡(luò)編程技巧總結(jié)》、《PHP基本語(yǔ)法入門教程》、《php面向?qū)ο蟪绦蛟O(shè)計(jì)入門教程》及《php優(yōu)秀開發(fā)框架總結(jié)》

希望本文所述對(duì)大家PHP程序設(shè)計(jì)有所幫助。