PHP單元測試框架PHPUnit的使用方法

一个新手
發布: 2023-03-16 19:02:02
原創
7866 人瀏覽過

以前在學習IOS開發時有專門寫過Objective-C的單元測試的文章,IOS開發學習之單元測試,今天再總結下怎麼在PHP中使用單元測試。

一、前言

在這篇文章中,我們使用composer 的依賴套件管理工具進行phpunit套件安裝與管理,composer 官方地址https://getcomposer.org/,按照提示進行全域安裝即可,另外,我們也會使用一個非常好用的Monolog記錄日誌組件記錄日誌,方便我們查看。

在根目錄下建立coomposer.json 的設定檔,輸入以下內容:

{
    "autoload": {
        "classmap": [
            "./"
        ]
    }
}
登入後複製

上面的意思是將根目錄下的所有的類檔案都載入進來, 在命令列執行composer install 後,在根目錄會產生一個vendor的資料夾,我們以後透過composer安裝的任何第三方程式碼都會被產生在這裡。

二、為什麼要單元測試?

只要你想到輸入一些東西到print語句或調試表達式中,就用測試代替它。  --Martin Fowler

PHPUnit 是一個用PHP程式語言開發的開源軟體,是一個單元測試框架。 PHPUnit由Sebastian Bergmann創建,源自於Kent Beck的SUnit,是xUnit家族的框架之一。

單元測試是對單獨的程式碼物件進行測試的過程,例如對函數、類別、方法進行測試。單元測試可以使用任一段已經寫好的測試程式碼,也可以使用一些已經存在的測試框架,例如JUnit、PHPUnit或Cantata++,單元測試框架提供了一系列共同、有用的功能來幫助人們編寫自動化的檢測單元,例如檢查一個實際的值是否符合我們期望的值的斷言。單元測試框架經常包含每個測試的報告,以及給出你已經涵蓋到的程式碼覆蓋率。

總之一句話,使用phpunit 進行自動測試,會使你的程式碼更健壯,減少後期維護的成本,也是一種比較標準的規範,現如今流行的PHP框架都帶了單元測試,如Laraval,Symfony,Yii2等,單元測試已經成了標配。

另外,單元測試案例是透過命令操控測試腳本的,而不是透過瀏覽器存取URL的。

三、安裝PHPUnit

使用composer 方式安裝PHPUnit,其他安裝方式請看這裡

composer require --dev phpunit/phpunit ^6.2
登入後複製

安裝Monolog 日誌包,做phpunit 測試記錄日誌用。

composer require monolog/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、测试案例
 *
 *
 */
namespace App\tests;
require_once __DIR__ . &#39;/../vendor/autoload.php&#39;;
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, &#39;foo&#39;);

        // 添加日志文件,如果没有安装monolog,则有关monolog的代码都可以注释掉
        $this->Log()->error(&#39;hello&#39;, $stack);

        $this->assertEquals(&#39;foo&#39;, $stack[count($stack)-1]);
        $this->assertEquals(1, count($stack));

        $this->assertEquals(&#39;foo&#39;, array_pop($stack));
        $this->assertEquals(0, count($stack));
    }

    public function Log()
    {
        // create a log channel
        $log = new Logger(&#39;Tester&#39;);
        $log->pushHandler(new StreamHandler(ROOT_PATH . &#39;storage/logs/app.log&#39;, Logger::WARNING));
        $log->error("Error");
        return $log;
    }
}
登入後複製

程式碼解釋:

  1. StackTest為測試類別

  2. #StackTest 繼承於PHPUnit\Framework\TestCase

  3. #測試方法testPushAndPop(),測試方法必須為public權限,一般以test開頭,或者你也可以選擇給其加註解@test來表

  4. 在測試方法內,類似於assertEquals() 這樣的斷言方法用來對實際值與預期值的匹配做出斷言。

命令列執行:
phpunit 命令測試檔案命名

➜  framework#  ./vendor/bin/phpunit tests/StackTest.php

// 或者可以省略文件后缀名
//  ./vendor/bin/phpunit tests/StackTest
登入後複製

執行結果:

➜  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;  
    }  
}  
?>
登入後複製
登入後複製

單元測試類別:
CalculatorTest.php

<?php

namespace App\tests;
require_once __DIR__ . &#39;/../vendor/autoload.php&#39;;
require "Calculator.php";

use PHPUnit\Framework\TestCase;


class CalculatorTest extends TestCase
{
    public function testSum()
    {
        $obj = new Calculator;
        $this->assertEquals(0, $obj->sum(0, 0));

    }

}
登入後複製

指令執行:

> ./vendor/bin/phpunit tests/CalculatorTest
登入後複製

執行結果:

PHPUnit 6.4.1 by Sebastian Bergmann and contributors.

F                                                                   1 / 1 (100%)

Time: 117 ms, Memory: 4.00MB

There was 1 failure:
登入後複製

如果我們把這裡的斷言故意寫錯,$this->assertEquals(1, $obj->sum(0, 0));
看執行結果:

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.
登入後複製

會直接報出方法錯誤訊息及行號,有助於我們快速找出bug

3、進階用法

#你是否已經厭煩了在每一個測試方法命名前面加一個test,是否因為只是呼叫的參數不同,卻要寫多個測試案例而糾結?我最喜歡的進階功能,現在隆重推薦給你,叫做框架產生器

Calculator.php

<?php  
class Calculator  
{  
    public function sum($a, $b)  
    {  
        return $a + $b;  
    }  
}  
?>
登入後複製
登入後複製

命令列啟動測試案例,使用關鍵字--skeleton

> ./vendor/bin/phpunit --skeleton Calculator.php
登入後複製

執行結果:

PHPUnit 6.4.1 by Sebastian Bergmann and contributors.

Wrote test class skeleton for Calculator to CalculatorTest.php.
登入後複製

是不是很簡單,因為沒有測試數據,所以這裡加測試數據,然後重新執行上邊的命令

<?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;  
    }  
}  
?>
登入後複製

原始類別中的每個方法都進行@assert註解的檢測。這些被轉變為測試程式碼,像這樣

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

執行結果:

登入後複製


以上是PHP單元測試框架PHPUnit的使用方法的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板