在不到一秒的時間內測試您的所有業務邏輯-php教程-PHP中文網

為了讓測驗通過，我故意走得快一點。現在，我可以花時間完善測試並以更好的方式實現程式碼。

測試翻譯了範例，但在翻譯過程中失去了使用者意圖。透過很少的函數，我可以使其更接近原始範例。

這不是本文的重點，所以我不會詳細介紹，但我可以使用豐富的領域模型更精確地表達領域模型。

正如您在文章開頭看到的，一個功能有很多範例來描述它。所以是時候全部實現它們了：

首頁

後端開發

php教程

在不到一秒的時間內測試您的所有業務邏輯

DDD

Dec 05, 2024 pm 01:22 PM

本文與測驗無關。這是關於採用一種工作流程，讓您在開發功能時保持控制。測試只是這個過程的引擎和美好的結果。

這個工作流程徹底改變了我的編碼方式，它總是讓我臉上露出笑容。我希望它對你也有同樣的作用。最後，您將擁有一個完全開發的功能，滿足所有業務規則，以及一個測試套件，可以在不到一秒鐘的時間內對其進行驗證。

我使用 PHP 進行演示，但此工作流程完全適用於任何語言。

工作流程和測試挫折

我從哪裡開始我的功能？

當需要開發新功能時，通常很難知道從哪裡開始。您應該從業務邏輯、控制器還是前端開始？

知道何時停止也同樣棘手。如果沒有明確的流程，衡量進度的唯一方法就是手動測試。一種乏味且容易出錯的方法。

別害怕，這只是一個 2000 行的文件，沒有任何測試？

你認識這個人。該文件發生了無法解釋的事情。您需要更改一行，但每次嘗試似乎都會破壞整個專案。如果沒有測試的安全網，重構就像在峽谷上走鋼索。

測試速度慢得令人痛苦

為了避免這種混亂，您決定透過端到端測試來測試每個功能。好主意！直到您意識到在等待測試套件完成時您有足夠的時間喝五杯咖啡。生產力？窗外。

每次重構後測試都會中斷

為了建立即時回饋，您決定為所有課程編寫細粒度的測驗。然而，現在您所做的每項更改都會導致一系列損壞的測試，並且您最終會花費更多的時間來修復它們，而不是進行實際的更改。這是令人沮喪的、低效的，並且讓你害怕每一次重構。

讓我們一起夢想吧！什麼是完美測試？

即時回饋

回饋是軟體開發每個階段的關鍵。在開發專案核心時，我需要即時回饋以立即了解我的任何業務規則是否被破壞。在重構過程中，有一個助手告訴我程式碼是否被破壞或我是否可以安全地繼續，這是一個無價的優勢。

注意行為

專案能夠做什麼，專案行為，是最重要的面向。這些行為應該以使用者為中心。即使實現（為使功能正常運作而創建的程式碼）發生變化，使用者的意圖也將保持不變。

例如，當使用者下訂單時，他們希望收到通知。通知使用者的方式有很多種：電子郵件、簡訊、郵件等。雖然使用者的意圖不會改變，但實施往往會改變。

如果測試代表了使用者的意圖並且程式碼不再滿足該意圖，則測試應該失敗。但是，在重構期間，如果程式碼仍然符合使用者的意圖，則測試不應該中斷。

副駕駛

想像一下在創建新功能的過程中一步步被引導。透過先編寫測試，它將成為您編寫正確功能的指南。可能還不完全清楚，但我希望我的測試在編碼時能充當我的 GPS。透過這種方法，我不需要考慮下一步，我只需按照 GPS 指示操作即可。如果這個概念仍然不清楚，別擔心！我將在工作流程部分詳細解釋。？

開始之前的一些要求

功能和驗收測試

正如我在簡介中提到的，本文不是關於測試，而是關於創建功能。為此，我需要一個功能。更具體地說，我需要一個帶有範例定義的驗收測試的功能。對於每項功能，團隊應建立驗收標準或規則，並為每項規則建立一個或多個範例。

⚠️ 這些範例必須以使用者/網域為中心，不描述任何技術方面。檢查範例是否定義良好的一個簡單方法是問自己：「我的範例是否適用於任何實作（Web 前端、HTTP API、終端 CLI、現實生活等）？」

例如，如果我想開發「將產品加入購物籃」功能，我的範例可能如下所示：

Test All your Business Logic in less than econd

這些範例將作為測試的基礎。對於更複雜的場景，我使用給定/何時/然後模式來獲取更多細節，但對於更簡單的場景則沒有必要。

以領域為中心的架構

即時回饋和對行為的關注，這不是一個很大的挑戰嗎？使用 Symfony MVC 服務架構，要實現這一點可能很困難。這就是為什麼我將使用以領域為中心的架構，我在本文中詳細介紹了這一點：建構 Symfony 專案的另一種方法。

以行為為重點的測試

為了專注於行為，我需要以正確的方式建立測驗。首先，我描述使用者操作之前系統的狀態。接下來，我執行使用者操作，這會更改系統的狀態。最後，我斷言系統的狀態符合我的期望。

以這種方式測試，測試並不關心系統如何處理使用者操作；它只檢查操作是否成功。這意味著如果我們更改使用者操作的實現，測試不會中斷。但是，如果實作無法如預期更新系統狀態，則測試將中斷－而這正是我們想要的！

偽造 I/O

為了實現即時回饋，需要模擬系統的某些部分。以域為中心的架構使這成為可能，因為域僅依賴與外部程式庫互動的介面。這使得偽造這些依賴關係變得非常容易，從而使功能測試運行得非常快。當然，真正的實作也將使用整合測試進行測試（儘管不在本文中）。

GPS 工作流程

在這個工作流程中，測試的是我的 GPS！我設定一個目的地，讓它引導我，並在我到達時通知我。測試將根據團隊提供的範例進行。

Test All your Business Logic in less than econd

輸入您的目的地

為了測試業務邏輯和使用者意圖，我使用功能測試：

// tests/Functional/AddProductToBasketTest.php

namespace App\Tests\Functional;

use PHPUnit\Framework\TestCase;

class AddProductToBasketTest extends TestCase
{

    public function testAddProductToBasket() {

    }
}

登入後複製

此文件將包含此功能的所有測試，但讓我們從第一個開始。

安排

在第一部分中，我描述了應用程式的狀態。這裡，有一個空籃子供 ID 為「1」的顧客使用。

$customerId = 1;
$productId = 1;
$basketId = 1;

$basket = new Basket($basketId, customerId: $customerId);

$inMemoryBasketRepository = new InMemoryBasketRepository(baskets: [$basket]);

登入後複製

行為

handler和command代表了使用者的意圖，這樣就很明確了，大家都明白。

$commandHandler = new AddProductToBasketCommandHandler(
            $inMemoryBasketRepository,
        );
$commandHandler(new AddProductToBasketCommand(customerId: $customerId, basketId: $basketId, productId: $productId));

登入後複製

？：我決定將這個專案中的命令和查詢分開，但我們可以有一個 AddProductToBasketUseCase。

斷言

最後，是時候描述一下最終結果應該是什麼樣子了。我希望我的購物籃裡有合適的產品。

$expectedBasket = new Basket($basketId, $customerId, array($productId));

$this->assertEquals($expectedBasket, $inMemoryBasketRepository->baskets[0]);

登入後複製

目的地

這是將第一個範例轉換為程式碼的測試。

// tests/Functional/AddProductToBasketTest.php

namespace App\Tests\Functional;

use PHPUnit\Framework\TestCase;

class AddProductToBasketTest extends TestCase
{
    public function testAddProductToBasket(): void {
        // Arrange
        $customerId = 1;
        $productId = 1;
        $basketId = 1;
        $basket = new Basket($basketId, customerId: $customerId);
        $inMemoryBasketRepository = new InMemoryBasketRepository(baskets: [$basket]);

        // Act
        $commandHandler = new AddProductToBasketCommandHandler(
            $inMemoryBasketRepository,
        );
        $commandHandler(new AddProductToBasketCommand(customerId: $customerId, basketId: $basketId, productId: $productId));

        // Assert
        $expectedBasket = new Basket($basketId, $customerId, array($productId));
        $this->assertEquals($expectedBasket, $inMemoryBasketRepository->baskets[0]);
    }
}

登入後複製

不要害怕錯誤

此時，我的 IDE 到處都顯示錯誤，因為我在此測試中使用的任何內容都不存在。但這些真的是錯誤嗎，還是只是我們邁向目的地的下一步？我將這些錯誤視為指令，每次執行測試時，它都會告訴我們下一步該做什麼。這樣我就不用想太多；我只是跟著GPS走。

？ 提示：為了改善開發人員體驗，您可以啟用檔案觀察器，該觀察器會在您進行變更時自動執行測試套件。由於測試套件速度非常快，因此您將在每次更新時獲得即時回饋。

在這個例子中，我將一一解決每個錯誤。當然，如果你有信心，你可以走捷徑。？

那麼，讓我們來進行測試吧！對於每個錯誤，我都會執行下一步所需的最低限度的操作。

使測試編譯

❌？：「錯誤：找不到類別「AppTestsFunctionalBasket」」

由於這是此功能的第一次測試，因此大多數類別尚不存在。所以第一步，我建立一個籃子物件：

// tests/Functional/AddProductToBasketTest.php

namespace App\Tests\Functional;

use PHPUnit\Framework\TestCase;

class AddProductToBasketTest extends TestCase
{

    public function testAddProductToBasket() {

    }
}

登入後複製

❌？：「錯誤：找不到類別「AppTestsFunctionalInMemoryBasketRepository」」

我建立了 InMemoryBasketRepository :

$customerId = 1;
$productId = 1;
$basketId = 1;

$basket = new Basket($basketId, customerId: $customerId);

$inMemoryBasketRepository = new InMemoryBasketRepository(baskets: [$basket]);

登入後複製

❌？：「錯誤：找不到類別「AppTestsFunctionalAddProductToBasketCommandHandler」」

我在 Catalog/Application 資料夾中建立 AddProductToBasketCommandHandler，該處理程序將成為「將產品新增至購物籃」功能的入口點。

$commandHandler = new AddProductToBasketCommandHandler(
            $inMemoryBasketRepository,
        );
$commandHandler(new AddProductToBasketCommand(customerId: $customerId, basketId: $basketId, productId: $productId));

登入後複製

為了尊重以領域為中心的架構，我為儲存庫創建了一個接口，這樣我們就反轉了依賴關係。

$expectedBasket = new Basket($basketId, $customerId, array($productId));

$this->assertEquals($expectedBasket, $inMemoryBasketRepository->baskets[0]);

登入後複製

❌？ : 「TypeError : AppCatalogApplicationCommandAddProductToBasketAddProductToBasketCommandHandler::__construct(): 參數 #1 ($basketRepository) 必須是 AppCatalogDomainBasketRepository、AppCatalogetRepository類型給定“

現在，InMemory 實作必須實作該介面才能注入到命令處理程序中。

// tests/Functional/AddProductToBasketTest.php

namespace App\Tests\Functional;

use PHPUnit\Framework\TestCase;

class AddProductToBasketTest extends TestCase
{
    public function testAddProductToBasket(): void {
        // Arrange
        $customerId = 1;
        $productId = 1;
        $basketId = 1;
        $basket = new Basket($basketId, customerId: $customerId);
        $inMemoryBasketRepository = new InMemoryBasketRepository(baskets: [$basket]);

        // Act
        $commandHandler = new AddProductToBasketCommandHandler(
            $inMemoryBasketRepository,
        );
        $commandHandler(new AddProductToBasketCommand(customerId: $customerId, basketId: $basketId, productId: $productId));

        // Assert
        $expectedBasket = new Basket($basketId, $customerId, array($productId));
        $this->assertEquals($expectedBasket, $inMemoryBasketRepository->baskets[0]);
    }
}

登入後複製

❌？：_「錯誤：找不到類別「AppTestsFunctionalAddProductToBasketCommand」」
_

我建立了一個命令，因為命令始終是 DTO，所以我將其標記為唯讀並將所有屬性公開。

// src/Catalog/Domain/Basket.php

namespace App\Catalog\Domain;

class Basket
{

    public function __construct(
        public readonly string $id,
        public readonly string $customerId,
        public array $products = [],
    )
    {
    }
}

登入後複製

❌？ : 「斷言兩個物件相等失敗。」

測試正在編譯中！它還是紅色的，所以我們還沒有完成，讓我們繼續吧！？

讓我們來看看業務邏輯

是時候編寫業務邏輯了。就像我編寫測試時一樣，即使什麼都不存在，我也會編寫我期望處理程序處理命令的方式。它無法編譯，但測試將再次引導我進行下一步。

// src/Catalog/Infrastructure/Persistence/InMemory/InMemoryBasketRepository.php

namespace App\Catalog\Infrastructure\Persistence\InMemory;

class InMemoryBasketRepository
{

    public function __construct(
        public array $baskets
    )
    {
    }
}

登入後複製

❌？ : 「錯誤：呼叫未定義的方法 AppCatalogInfrastructPersistenceInMemoryInMemoryBasketRepository::get()」

我在儲存庫介面中建立 get 方法：

// tests/Functional/AddProductToBasketTest.php

namespace App\Tests\Functional;

use PHPUnit\Framework\TestCase;

class AddProductToBasketTest extends TestCase
{

    public function testAddProductToBasket() {

    }
}

登入後複製

❌？ : 「PHP 致命錯誤：類別 AppCatalogInfrastructPersistenceInMemoryInMemoryBasketRepository 包含 1 個抽象方法，因此必須宣告為抽象方法或實作其餘方法 (AppCatalogDomainBasketRepository::getget)」
現在我在 InMemory 儲存庫中實作它。由於它只是為了測試，我創建了一個非常簡單的實作：

$customerId = 1;
$productId = 1;
$basketId = 1;

$basket = new Basket($basketId, customerId: $customerId);

$inMemoryBasketRepository = new InMemoryBasketRepository(baskets: [$basket]);

登入後複製

❌？ :

「錯誤：呼叫未定義的方法 AppCatalogDomainBasket::add()」
我創建

add

方法並在籃子物件上實現它

$commandHandler = new AddProductToBasketCommandHandler(
            $inMemoryBasketRepository,
        );
$commandHandler(new AddProductToBasketCommand(customerId: $customerId, basketId: $basketId, productId: $productId));

登入後複製

❌？ :

錯誤：呼叫未定義的方法 AppCatalogInfrastructPersistenceInMemoryInMemoryBasketRepository::save()
同樣，我在介面中創建方法並在記憶體存儲庫中實現它：

$expectedBasket = new Basket($basketId, $customerId, array($productId));

$this->assertEquals($expectedBasket, $inMemoryBasketRepository->baskets[0]);

登入後複製

// tests/Functional/AddProductToBasketTest.php

namespace App\Tests\Functional;

use PHPUnit\Framework\TestCase;

class AddProductToBasketTest extends TestCase
{
    public function testAddProductToBasket(): void {
        // Arrange
        $customerId = 1;
        $productId = 1;
        $basketId = 1;
        $basket = new Basket($basketId, customerId: $customerId);
        $inMemoryBasketRepository = new InMemoryBasketRepository(baskets: [$basket]);

        // Act
        $commandHandler = new AddProductToBasketCommandHandler(
            $inMemoryBasketRepository,
        );
        $commandHandler(new AddProductToBasketCommand(customerId: $customerId, basketId: $basketId, productId: $productId));

        // Assert
        $expectedBasket = new Basket($basketId, $customerId, array($productId));
        $this->assertEquals($expectedBasket, $inMemoryBasketRepository->baskets[0]);
    }
}

登入後複製

✅？：

目的地到達！？？？

透過這個工作流程，我已經將開發者體驗遊戲化了。在完成紅色測驗的挑戰後，看到它變成綠色，就會注射多巴胺??

重構時間

為了讓測驗通過，我故意走得快一點。現在，我可以花時間完善測試並以更好的方式實現程式碼。

測試

測試翻譯了範例，但在翻譯過程中失去了使用者意圖。透過很少的函數，我可以使其更接近原始範例。

範例：

Test All your Business Logic in less than econd

檢定：

// src/Catalog/Domain/Basket.php

namespace App\Catalog\Domain;

class Basket
{

    public function __construct(
        public readonly string $id,
        public readonly string $customerId,
        public array $products = [],
    )
    {
    }
}

登入後複製

程式碼

這不是本文的重點，所以我不會詳細介紹，但我可以使用豐富的領域模型更精確地表達領域模型。

由於測驗是綠色的，現在我可以隨心所欲地重構，測驗有我的支持。？

其他例子

正如您在文章開頭看到的，一個功能有很多範例來描述它。所以是時候全部實現它們了：

// src/Catalog/Infrastructure/Persistence/InMemory/InMemoryBasketRepository.php

namespace App\Catalog\Infrastructure\Persistence\InMemory;

class InMemoryBasketRepository
{

    public function __construct(
        public array $baskets
    )
    {
    }
}

登入後複製

我已經通過不同的測試多次遵循此工作流程，並且我的程式碼的各個部分已經發展到與業務規則保持一致。正如您在第一個測試中看到的那樣，我的物件非常簡單，有時甚至是基本的。然而，隨著新業務規則的引入，它們促使我開發一個更聰明的領域模型。這是我的資料夾結構：

Test All your Business Logic in less than econd

為了簡化測試，同時保留域模型的封裝，我引入了建構器和快照模式。

// tests/Functional/AddProductToBasketTest.php

namespace App\Tests\Functional;

use PHPUnit\Framework\TestCase;

class AddProductToBasketTest extends TestCase
{

    public function testAddProductToBasket() {

    }
}

登入後複製

$customerId = 1;
$productId = 1;
$basketId = 1;

$basket = new Basket($basketId, customerId: $customerId);

$inMemoryBasketRepository = new InMemoryBasketRepository(baskets: [$basket]);

登入後複製

$commandHandler = new AddProductToBasketCommandHandler(
            $inMemoryBasketRepository,
        );
$commandHandler(new AddProductToBasketCommand(customerId: $customerId, basketId: $basketId, productId: $productId));

登入後複製

我要如何使用它：

$expectedBasket = new Basket($basketId, $customerId, array($productId));

$this->assertEquals($expectedBasket, $inMemoryBasketRepository->baskets[0]);

登入後複製