使用PHP和PHPUnit實現單元測試和程式碼覆蓋率

隨著軟體開發的發展，越來越多的開發人員意識到單元測試的重要性。單元測試是一種在軟體開發中常見的測試方法，透過測試單一功能模組（也稱為「單元」）的正確性，確保程式碼的正確性和穩定性。在本文中，我們將介紹如何使用PHP和PHPUnit實現單元測試和程式碼覆蓋率。

PHPUnit是一個開源的測試框架，用於對PHP程式碼進行測試。它支援多種測試類型，包括單元測試、功能測試和整合測試。在本文中，我們將重點放在單元測試。

為什麼要進行單元測試和程式碼覆蓋率？

在開發軟體時，我們通常會盡可能嘗試測試我們的程式碼。單元測試是一種效率較高的測試方法，可在開發過程中持續進行測試，確保程式碼的正確性。此外，它還有以下幾個好處：

1. 提高程式碼可維護性：透過單元測試，您可以在修改程式碼後快速檢查程式碼的正確性，以確保修改後沒有損壞原有的功能。
2. 提高程式碼的健全性：透過對每個單元進行測試，可以發現程式碼中的潛在問題和錯誤，從而提前處理這些問題，避免在生產環境中引起問題。
3. 降低擴充功能和重構成本：單元測試可以幫助您在修改現有程式碼時快速發現問題，從而更有效地管理程式碼庫中的變更。

程式碼覆蓋率是評估測試覆蓋率的一種方法。它可以告訴您程式碼被測試到了多少程度。例如，如果您的測試覆蓋率為60％，則表示您的測試程式碼覆蓋了原始程式碼的60％。透過程式碼覆蓋率，您可以衡量您的軟體品質是否高，以及您是否需要更多的測試案例。

開始使用PHPUnit進行單元測試

在繼續之前，需要確保您已經安裝了PHPUnit。可以透過Composer進行安裝。在您的專案目錄中建立composer.json文件，並新增PHPUnit依賴項：

{
  "require-dev": {
    "phpunit/phpunit": "^7.0"
  }
}

執行以下命令可以安裝PHPUnit：

composer install --dev

接下來，我們將示範如何編寫一個簡單的單元測試。想像一下，您正在編寫一個名為“Calculator”的PHP類，用於執行基本的算術運算。以下是它的程式碼：

class Calculator {
    public function add($a, $b) {
        return $a + $b;
    }

    public function subtract($a, $b) {
        return $a - $b;
    }
}

現在，寫一個名為「CalculatorTest」的測試類，它將測試我們的Calculator類：

use PHPUnitFrameworkTestCase;

class CalculatorTest extends TestCase {
    public function testAdd() {
        $calculator = new Calculator();
        $result = $calculator->add(1, 2);
        $this->assertEquals(3, $result);
    }

    public function testSubtract() {
        $calculator = new Calculator();
        $result = $calculator->subtract(2, 1);
        $this->assertEquals(1, $result);
    }
}

在上述程式碼中，我們使用了PHPUnit提供的基本測試方法之一-assertEquals()。它將測試值與預期值進行比較，並在它們不相等時拋出異常。

現在執行PHPUnit測試：

./vendor/bin/phpunit CalculatorTest.php

如果所有測試都通過，將顯示以下輸出：

PHPUnit 7.5.1 by Sebastian Bergmann and contributors.

..

Time: 42 ms, Memory: 4.00 MB

OK (2 tests, 2 assertions)

注意，在本例中使用了一個小技巧，就是在同一個檔案CalculatorTest.php中同時定義了Calculator類別和其對應的測試類別CalculatorTest。

了解PHPUnit的基本測試方法

##PHPUnit提供了多種測試方法，以下是其中一些基本方法的使用範例：

assertEquals($expected, $actual, $message)：比較預期值和實際值是否相等。
1. assertTrue($value, $message)：判斷一個表達式是否為真。
2. assertFalse($value, $message)：判斷一個表達式是否為假。
3. assertNull($value, $message)：判斷一個值是否為null。
4. assertSame($expected, $actual, $message)：比較預期值和實際值是否完全相等（包含類型）。
5. assertInstanceOf($expected, $actual, $message)：判斷一個物件是否為特定類別的實例。

PHPUnit的更多測試方法可以在文件中找到。

使用PHPUnit進行程式碼覆蓋率測試

我們已經了解如何使用PHPUnit進行單元測試。現在，讓我們了解如何使用PHPUnit進行程式碼覆蓋率測試。

為了實現程式碼覆蓋率，我們需要在執行PHPUnit時加入--coverage-html選項。它將產生一個HTML程式碼覆蓋率報告。執行以下指令即可：

./vendor/bin/phpunit --coverage-html reports tests

這個指令運行我們專案中test目錄下的所有測試案例，並在執行後在reports目錄下產生程式碼覆蓋率報告。

在此之後，您可以在瀏覽器中開啟HTML報告，以查看原始程式碼的覆蓋範圍。

總結

在本文中，我們介紹如何使用PHPUnit進行單元測試和程式碼覆蓋率。透過單元測試和程式碼覆蓋率，您可以增強專案品質和穩定性，並降低擴展和重構的成本。

在您編寫PHP程式碼時，請謹記編寫良好的單元測試。一個好的單元測試用於驗證程式碼正確性、防止回歸錯誤和保證程式碼健全性。透過編寫良好的測試案例，您可以儘早發現問題並提前解決問題。

以上是使用PHP和PHPUnit實現單元測試和程式碼覆蓋率的詳細內容。更多資訊請關注PHP中文網其他相關文章！