PHP 7新特性詳解：使用Expectations語法輕鬆編寫斷言

M66 2025-10-27

導言

隨著PHP 7的發布，開發者迎來了許多新的功能和改進。其中，Expectations語法是最受關注的功能之一。它可以大幅簡化斷言的編寫，使代碼更易讀、易維護。本文將介紹Expectations語法的基本用法，並通過示例展示其優勢。

什麼是Expectations語法？

在PHP中，斷言用於驗證代碼中的條件。傳統斷言通常使用assert()函數，將條件表達式作為參數，在條件不滿足時拋出錯誤。這樣的寫法既冗長又不夠直觀。

Expectations語法通過expect()函數簡化了斷言的書寫。我們可以使用expect()來驗證一個值或表達式是否符合預期。當斷言失敗時，expect()會拋出包含錯誤信息和斷言失敗位置的異常。

Expectations語法的使用方法

下面通過具體示例展示如何使用Expectations語法改進斷言。

示例：簡單斷言

假設我們有一個函數add()，用於將兩個數相加並返回結果。我們可以使用Expectations語法驗證函數的返回值是否符合預期。

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

// 使用Expectations語法斷言add()函數的返回值是否為3
expect(add(1, 2))->toBe(3);

在此例中，expect()函數斷言add(1, 2)的返回值是否等於3。若斷言失敗，將拋出詳細的AssertionException異常。

示例：斷言數組

Expectations語法也適用於數組斷言。以下示例展示如何使用toBe()和toContain()驗證數組內容。

 $data = ['apple', 'banana', 'orange'];

// 斷言數組$data長度為3
expect($data)->toHaveLength(3);

// 斷言數組$data中包含'banana'
expect($data)->toContain('banana');

通過toHaveLength()和toContain()函數，可以方便地驗證數組長度和包含的元素。

示例：自定義斷言函數

除了內置斷言函數，還可以自定義斷言函數，以滿足項目特定需求。

 function isEven($num) {
    return $num % 2 == 0;
}

// 斷言數字6為偶數
expect(6)->toBeTrue(isEven);

此示例定義了isEven()函數判斷數字是否為偶數，然後使用toBeTrue()斷言數字6是否為偶數。

結論

PHP 7的Expectations語法提供了一種更簡潔、直觀的斷言方式。通過expect()函數，開發者可以編寫可讀性高、易於維護的代碼。上述示例有助於快速理解和應用Expectations語法，是優化PHP測試代碼的利器。