如何在 PHP 中執(zhí)行單元測(cè)試：工具和最佳實(shí)踐

單元測(cè)試是軟體開發(fā)生命週期的關(guān)鍵部分，可確保應(yīng)用程式的各個(gè)元件或功能如預(yù)期運(yùn)作。在 PHP 中，單元測(cè)試有助於驗(yàn)證程式碼的正確性，使開發(fā)人員能夠及早發(fā)現(xiàn) bug，提高程式碼的可靠性和可維護(hù)性。

在 PHP 中執(zhí)行單元測(cè)試涉及為小型、獨(dú)立的功能（單元）編寫測(cè)試，通常使用專門的測(cè)試框架和工具。以下深入說明如何在 PHP 中進(jìn)行單元測(cè)試、常用的工具和框架以及要遵循的最佳實(shí)務(wù)。

---

1. PHP 中的單元測(cè)試是什麼？

單元測(cè)試涉及單獨(dú)測(cè)試各個(gè)程式碼單元（稱為函數(shù)或方法），以確保它們按預(yù)期執(zhí)行。單元測(cè)試的首要目標(biāo)是驗(yàn)證每個(gè)單元的正確性，幫助及早發(fā)現(xiàn) bug，讓開發(fā)人員放心重構(gòu)或修改程式碼。

單元測(cè)試檢查特定輸入的函數(shù)或方法的行為，並將實(shí)際輸出與預(yù)期輸出進(jìn)行比較。單元測(cè)試通常是自動(dòng)化的，並且可以連續(xù)運(yùn)行以保持高程式碼品質(zhì)。

---

2.單元測(cè)試的主要好處

• 早期錯(cuò)誤偵測(cè)：單元測(cè)試有助於及早發(fā)現(xiàn)錯(cuò)誤和錯(cuò)誤，從而更容易在它們影響應(yīng)用程式的較大部分之前修復(fù)它們。
• 重建信心：透過適當(dāng)?shù)膯卧獪y(cè)試，開發(fā)人員可以自信地進(jìn)行更改或重構(gòu)程式碼，因?yàn)橹罍y(cè)試會(huì)捕獲任何回歸。
• 提高程式碼品質(zhì)：編寫單元測(cè)試迫使開發(fā)人員編寫模組化、可維護(hù)且結(jié)構(gòu)良好的程式碼，從而促進(jìn)更好的設(shè)計(jì)實(shí)踐。
• 文件：單元測(cè)試充當(dāng)函數(shù)和方法的預(yù)期行為的活文檔。

---

3. PHP 單元測(cè)試工具與框架

PHP 中的一些工具和框架可以幫助您編寫和執(zhí)行單元測(cè)試。最受歡迎的是 PHPUnit、Mockery 和 PHPSpec。以下是這些工具的概述：

a. PHPUnit

PHPUnit 是最廣泛使用的 PHP 測(cè)試框架。它是一個(gè)開源工具，提供了一種編寫和運(yùn)行單元測(cè)試的簡單方法。 PHPUnit 的靈感來自 xUnit 系列框架（例如用於 Java 的 JUnit 和用於 .NET 的 NUnit）。

• 安裝：PHPUnit 可以透過 PHP 依賴管理器 Composer 安裝。

composer require --dev phpunit/phpunit

• 基本範(fàn)例：

// Example: A simple Calculator class
class Calculator {
    public function add($a, $b) {
        return $a + $b;
    }
}

// PHPUnit test for Calculator class
use PHPUnit\Framework\TestCase;

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

• 運(yùn)行 PHPUnit:

要使用 PHPUnit 執(zhí)行測(cè)試，請(qǐng)使用下列指令：

./vendor/bin/phpunit tests/CalculatorTest.php

PHPUnit 功能：

• Assertions：提供多種斷言方法，如assertEquals、assertTrue、assertFalse、assertContains等，用於驗(yàn)證測(cè)試結(jié)果。
• 測(cè)試套件：將多個(gè)測(cè)試組合在一起並將它們作為一個(gè)套件運(yùn)行。
• 模擬：建立模擬物件來模擬測(cè)試過程中的依賴關(guān)係。
• 程式碼覆蓋率：PHPUnit 可以產(chǎn)生程式碼覆蓋率報(bào)告來衡量測(cè)試涵蓋了多少程式碼。

b.嘲諷

Mockery 是一個(gè)與 PHPUnit 一起使用的模擬框架，用於模擬物件並模擬依賴項(xiàng)的行為。在測(cè)試具有外部相依性的元件（例如資料庫連線、API 或服務(wù)）時(shí)，它允許進(jìn)行更細(xì)粒度的控制。

• 安裝：Mockery 可以透過 Composer 安裝。

composer require --dev mockery/mockery

• 範(fàn)例：

use Mockery;
use PHPUnit\Framework\TestCase;

class UserServiceTest extends TestCase {
    public function testGetUserName() {
        // Create a mock UserRepository
        $userRepository = Mockery::mock(UserRepository::class);
        $userRepository->shouldReceive('find')->with(1)->andReturn(new User('John Doe'));

        $userService = new UserService($userRepository);
        $userName = $userService->getUserName(1);

        $this->assertEquals('John Doe', $userName);
    }

    public function tearDown(): void {
        Mockery::close();  // Clean up mock objects
    }
}

c. PHP 規(guī)格

PHPSpec 是 PHP 的行為驅(qū)動(dòng)開發(fā) (BDD) 框架。 PHPUnit 專注於為程式碼單元編寫測(cè)試，而 PHPSpec 則專注於指定類別和物件的行為。它允許用更自然的語言編寫測(cè)試，並且通常用於從外到內(nèi)驅(qū)動(dòng)開發(fā)。

• 安裝：

composer require --dev phpspec/phpspec

• 基本範(fàn)例：

// Spec for Calculator class
class CalculatorSpec extends \PhpSpec\ObjectBehavior {
    function it_adds_two_numbers() {
        $this->add(2, 3)->shouldReturn(5);
    }
}

---

4. PHP 單元測(cè)試的最佳實(shí)務(wù)

以下是在 PHP 中編寫單元測(cè)試時(shí)應(yīng)遵循的一些最佳實(shí)踐：

a.一次測(cè)試一件事

每個(gè)測(cè)試應(yīng)該只驗(yàn)證一種特定的行為或功能。這使得測(cè)試更容易理解、維護(hù)和調(diào)試。

b.保持測(cè)試隔離

單元測(cè)試應(yīng)該相互獨(dú)立。每個(gè)測(cè)試應(yīng)獨(dú)立於其他測(cè)試運(yùn)行，以確保其可靠且可重複。

c.使用模擬依賴

如果您的程式碼依賴外部服務(wù)、資料庫或 API，請(qǐng)使用模擬來模擬它們的行為。這可以防止您的測(cè)試依賴真實(shí)的外部系統(tǒng)，確保它們運(yùn)作得更快、更可靠。

d.在編碼之前編寫測(cè)試（測(cè)試驅(qū)動(dòng)開發(fā)）

遵循 TDD（測(cè)試驅(qū)動(dòng)開發(fā)）有助於確保編寫程式碼時(shí)考慮到可測(cè)試性。首先編寫測(cè)試，然後編寫使它們通過的程式碼。

e.使用描述性檢定名稱

使用描述性測(cè)試名稱來解釋正在測(cè)試的行為。這可以幫助其他人（以及未來的你）了解每次測(cè)試的目的。

composer require --dev phpunit/phpunit

f.定期執(zhí)行測(cè)試

將您的測(cè)試整合到持續(xù)整合 (CI) 管道中，以便它們?cè)诿看翁峤粫r(shí)自動(dòng)執(zhí)行。這可確保新的變更不會(huì)破壞現(xiàn)有功能。

---

5.使用 PHPUnit 進(jìn)行完整單元測(cè)試的範(fàn)例

讓我們來看看使用 PHPUnit 對(duì)類別進(jìn)行單元測(cè)試的完整範(fàn)例。

要測(cè)試的類別（Calculator.php）：

// Example: A simple Calculator class
class Calculator {
    public function add($a, $b) {
        return $a + $b;
    }
}

// PHPUnit test for Calculator class
use PHPUnit\Framework\TestCase;

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

單元測(cè)試類別（CalculatorTest.php）：

./vendor/bin/phpunit tests/CalculatorTest.php

執(zhí)行測(cè)試：

composer require --dev mockery/mockery

---

6.結(jié)論

單元測(cè)試是確保軟體品質(zhì)的重要組成部分，尤其是在 PHP 應(yīng)用程式中。透過使用 PHPUnit、Mockery 和 PHPSpec 等測(cè)試框架，您可以編寫自動(dòng)化測(cè)試來幫助驗(yàn)證程式碼的正確性。單元測(cè)試提供了多種好處，例如早期錯(cuò)誤檢測(cè)、重構(gòu)期間的程式碼信心以及更好的整體軟體品質(zhì)。

透過遵循最佳實(shí)踐，例如編寫?yīng)毩⒌拿枋鲂詼y(cè)試以及使用模擬來模擬依賴關(guān)係，您可以編寫有效且可維護(hù)的單元測(cè)試，從而有助於專案的長期成功。

以上是掌握 PHP 單元測(cè)試：工具、框架與最佳實(shí)踐的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！