使用 PHPUnit 測試 PHP 程式碼的初學者指南

如何使用 PHPUnit 開始在 PHP 中進行測試 以及逐步指南。

第 1 步：安裝 PHPUnit

開始編寫測試之前，您需要在專案中安裝 PHPUnit。

您可以使用 Composer 全域安裝它：

composer global require phpunit/phpunit

或為特定項目在本地安裝：

composer require --dev phpunit/phpunit

安裝後，您可以透過執行確認安裝：

./vendor/bin/phpunit --version

第 2 步：建立一個範例類別進行測試

讓我們建立一個簡單的計算器類別來增加兩個數字。這門課將是我們測驗的科目。

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

步驟 3： 建立 PHPUnit 測試用例

接下來，建立一個測試類別來為 Calculator 類別編寫測試。按照慣例，PHPUnit 測試檔案應以 Test.php 結尾，並放置在測試目錄中。

// tests/CalculatorTest.php

use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase
{
    public function testAddition()
    {
        // Arrange: Create a new Calculator instance
        $calculator = new Calculator();

        // Act: Perform the add operation
        $result = $calculator->add(2, 3);

        // Assert: Verify the result is 5
        $this->assertEquals(5, $result);
    }
}

逐部分細分

1. 測試班:
   
   測試類別CalculatorTest 擴充了TestCase，它是PHPUnit 提供的基底類別。每個測試類別都應該繼承於此。

2. 安排：
   
   在 testAddition 方法中，我們實例化 Calculator 類別。此步驟設定測試所需的一切（通常稱為“安排”階段）。

3. 行動：
   
   我們使用值 2 和 3 呼叫 Calculator 類別中的 add() 方法。這是我們正在測試的操作或行為。

4. 斷言:
   
   最後，我們使用assertEquals()方法來驗證add(2, 3)的輸出確實是5。如果斷言為真，則測試通過；如果斷言為真，則測試通過；如果斷言為真，則測試通過。否則會失敗。

第 4 步：運行測試

要執行測試，請在終端機中執行以下命令：

./vendor/bin/phpunit tests

如果一切設定正確，您應該會看到類似以下的輸出：

PHPUnit 9.5.4 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time: 00:00.010, Memory: 4.00 MB

OK (1 test, 1 assertion)

第 5 步：擴充測試案例

讓我們再增加一個方法來測試減法，並編寫對應的測試案例。

更新計算器類別：

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

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

更新測試用例：

// tests/CalculatorTest.php
use PHPUnit\Framework\TestCase;

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

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

第 6 步：運行所有測試

再次執行測試以確保加法和減法方法都有效：

./vendor/bin/phpunit tests

如果兩項測試都通過，您應該看到：

PHPUnit 9.5.4 by Sebastian Bergmann and contributors.

..                                                                  2 / 2 (100%)

Time: 00:00.010, Memory: 4.00 MB

OK (2 tests, 2 assertions)

結論

現在您已經有了使用 PHPUnit 在 PHP 中進行測試的基本設定。以下是過程的快速回顧：

1. 使用 Composer 安裝 PHPUnit。
2. 建立您想要測試的 PHP 類別（例如計算器）。
3. 寫你的測試類別使用適當的測試方法來擴充TestCase。
4. 執行測試並在終端機中查看結果。

透過擴展此方法以涵蓋更複雜的場景，您將確保您的 PHP 程式碼按預期運作。

以上是使用 PHPUnit 測試 PHP 程式碼的初學者指南的詳細內容。更多資訊請關注PHP中文網其他相關文章！