如何在PHP 單元測試（PHPUnit）中測試array_change_key_case() 的行為？

M66 2025-04-25

array_change_key_case()是PHP 的一個常用函數，用於改變數組中所有鍵的大小寫。當你需要確保數組鍵名的大小寫一致性時，這個函數會非常有用。然而，在單元測試中，我們需要確保這個函數在不同情況下能夠正確地執行。這篇文章將介紹如何使用PHPUnit 對array_change_key_case()函數進行單元測試。

1. 簡單介紹array_change_key_case()函數

array_change_key_case()函數接受兩個參數：

array ：要處理的數組。
case （可選）：指定大小寫的轉換方式，默認值是CASE_LOWER ，表示轉換成小寫；可以傳遞CASE_UPPER ，表示轉換成大寫。

文法:

 array_change_key_case(array $array, int $case = CASE_LOWER): array

示例：

 $array = [
    "FirstName" => "John",
    "LastName"  => "Doe"
];

print_r(array_change_key_case($array, CASE_LOWER));

輸出：

 Array
(
    [firstname] => John
    [lastname] => Doe
)

2. 創建PHPUnit 測試用例

接下來，我們來編寫PHPUnit 測試用例，以確保array_change_key_case()能正常工作。假設我們要測試的是將數組的所有鍵轉化為小寫或大寫。

首先，確保你已經安裝了PHPUnit。如果還沒有安裝，你可以通過Composer 安裝它：

 composer require --dev phpunit/phpunit ^9

在PHPUnit 測試中，我們需要創建一個測試類，並在其中定義一些測試方法。下面是一個簡單的示例：

 <?php

use PHPUnit\Framework\TestCase;

class ArrayChangeKeyCaseTest extends TestCase
{
    // 測試將數組鍵名轉換為小寫
    public function testArrayChangeKeyCaseToLower()
    {
        $input = [
            "FirstName" => "John",
            "LastName"  => "Doe"
        ];

        $expected = [
            "firstname" => "John",
            "lastname"  => "Doe"
        ];

        $result = array_change_key_case($input, CASE_LOWER);

        $this->assertEquals($expected, $result);
    }

    // 測試將數組鍵名轉換為大寫
    public function testArrayChangeKeyCaseToUpper()
    {
        $input = [
            "firstName" => "John",
            "lastName"  => "Doe"
        ];

        $expected = [
            "FIRSTNAME" => "John",
            "LASTNAME"  => "Doe"
        ];

        $result = array_change_key_case($input, CASE_UPPER);

        $this->assertEquals($expected, $result);
    }

    // 測試空數組
    public function testArrayChangeKeyCaseWithEmptyArray()
    {
        $input = [];

        $result = array_change_key_case($input, CASE_UPPER);

        $this->assertEquals([], $result);
    }

    // 測試帶有 URL 鍵的數組
    public function testArrayChangeKeyCaseWithURL()
    {
        $input = [
            "UserURL" => "http://m66.net/profile",
            "ApiURL"  => "https://m66.net/api"
        ];

        $expected = [
            "userurl" => "http://m66.net/profile",
            "apiurl"  => "https://m66.net/api"
        ];

        $result = array_change_key_case($input, CASE_LOWER);

        $this->assertEquals($expected, $result);
    }
}

3. 解釋測試用例

testArrayChangeKeyCaseToLower() ：測試將數組的鍵轉換為小寫。
testArrayChangeKeyCaseToUpper() ：測試將數組的鍵轉換為大寫。
testArrayChangeKeyCaseWithEmptyArray() ：測試對空數組的行為。
testArrayChangeKeyCaseWithURL() ：測試帶有URL 鍵的數組，確保轉換後的鍵名為小寫，而URL 的值保持不變。

4. 運行PHPUnit 測試

將測試文件保存在tests目錄下，並使用以下命令運行PHPUnit 測試：

 ./vendor/bin/phpunit --bootstrap vendor/autoload.php tests/ArrayChangeKeyCaseTest

如果一切正常，你應該看到所有測試通過的輸出。

5. 總結

通過使用PHPUnit，我們能夠確保array_change_key_case()函數在多種場景下都能夠按預期工作。無論是簡單的鍵名大小寫轉換，還是包含URL 的複雜數組，正確的單元測試能夠確保我們在不同情況下的需求都能夠得到滿足。通過測試不同類型的輸入，我們可以更好地了解函數的行為，並確保代碼的健壯性。

array_change_key_case