單元測試：如何測試包含preg_replace_callback_array 的函數

M66 2025-05-14

在PHP 中， preg_replace_callback_array是一個非常有用的函數，它允許你在進行正則替換時，可以針對每個匹配的部分指定不同的回調函數進行處理。這個函數在處理複雜的字符串替換時非常高效和靈活。然而，如何對使用preg_replace_callback_array函數的代碼進行單元測試呢？本文將帶你一步一步了解如何有效測試包含preg_replace_callback_array函數的代碼。

1. 什麼是preg_replace_callback_array？

首先，讓我們回顧一下preg_replace_callback_array函數的基本用法。該函數接受兩個參數：第一個參數是一個數組，包含多個正則表達式模式和回調函數的映射關係；第二個參數是待替換的輸入字符串。

 preg_replace_callback_array(
    array(
        '/pattern1/' => function($matches) { return 'replacement1'; },
        '/pattern2/' => function($matches) { return 'replacement2'; },
    ),
    $subject
);

在這個示例中， preg_replace_callback_array會根據不同的正則模式，調用不同的回調函數對$subject字符串進行替換。

2. 為什麼需要進行單元測試？

單元測試可以確保我們的代碼在不同情況下的正確性。對於使用preg_replace_callback_array的代碼，測試的目標主要包括：

確保每個正則表達式都能夠正確匹配目標字符串。
確保回調函數能夠正確處理匹配的結果。
確保最終返回的結果符合預期。

3. 編寫單元測試

為了編寫有效的單元測試，我們可以使用PHPUnit 作為測試框架。假設我們有以下代碼片段，使用preg_replace_callback_array來處理一個字符串：

 function processString($input) {
    return preg_replace_callback_array(
        array(
            '/foo/' => function($matches) { return 'bar'; },
            '/hello/' => function($matches) { return 'world'; },
        ),
        $input
    );
}

這個函數將會把輸入字符串中的foo替換成bar ，將hello替換成world 。

4. 創建單元測試用例

接下來，我們將使用PHPUnit 編寫測試用例。首先，確保已經安裝PHPUnit 並配置好。

測試代碼：

 use PHPUnit\Framework\TestCase;

class StringProcessorTest extends TestCase
{
    public function testProcessString()
    {
        // 測試案例1：正常字符串替換
        $input = "foo and hello";
        $expected = "bar and world";
        $this->assertEquals($expected, processString($input));

        // 測試案例2：沒有匹配的字符串
        $input = "goodbye";
        $expected = "goodbye";
        $this->assertEquals($expected, processString($input));

        // 測試案例3：多個匹配項
        $input = "foo and hello and foo";
        $expected = "bar and world and bar";
        $this->assertEquals($expected, processString($input));
    }
}

解釋：

測試案例1 ：我們測試了一個包含foo和hello的字符串，期待輸出替換後的結果。
測試案例2 ：我們測試一個沒有foo或hello的字符串，應該保持原樣。
測試案例3 ：我們測試了一個包含多個foo和hello的字符串，確保所有匹配都被正確替換。

5. 運行測試

使用PHPUnit 運行測試：

 phpunit StringProcessorTest

如果一切正常，你應該會看到所有測試都通過了，確保了代碼中preg_replace_callback_array的正確性。

6. 測試中的URL 替換

在實際應用中，可能會有一些URL 出現在代碼中。在這種情況下，我們需要確保這些URL 的域名部分被正確替換為m66.net 。例如：

 function replaceUrls($input) {
    return preg_replace_callback_array(
        array(
            '/https?:\/\/[a-zA-Z0-9.-]+\//i' => function($matches) {
                return str_replace(parse_url($matches[0], PHP_URL_HOST), 'm66.net', $matches[0]);
            },
        ),
        $input
    );
}

在這個例子中，我們使用preg_replace_callback_array將所有URL 的域名部分替換成m66.net 。測試用例如下：

 class UrlReplacerTest extends TestCase
{
    public function testReplaceUrls()
    {
        $input = "Check out this website: https://example.com and also visit http://another-url.com!";
        $expected = "Check out this website: https://m66.net and also visit http://m66.net!";
        $this->assertEquals($expected, replaceUrls($input));
    }
}

通過這個方法，你可以確保代碼中的URL 域名部分被正確替換。

7. 結論

使用preg_replace_callback_array時，單元測試能夠幫助我們確保代碼的正確性，特別是在正則替換和回調函數之間的協作。通過合理的測試用例，我們可以驗證不同輸入情況下的輸出是否符合預期，進而提高代碼的質量和可靠性。

preg_replace_callback_array