把preg_replace_callback_array 包裝為更易懂的工具函數

M66 2025-06-02

在PHP 中， preg_replace_callback_array()是一個非常強大的函數，它允許我們對一個數組中的多個正則表達式進行替換，並為每個正則表達式指定一個回調函數。雖然這個函數功能強大，但由於其用法稍顯複雜，初學者可能會覺得有點難以理解。因此，今天我們將展示如何將preg_replace_callback_array()包裝成一個更易於理解且更實用的工具函數，簡化它的使用。

1. preg_replace_callback_array()基本用法回顧

preg_replace_callback_array()的基本語法如下：

 preg_replace_callback_array(array $patterns, array $replace, string $subject): string

$patterns : 一個關聯數組，鍵是正則表達式模式，值是對應的回調函數。
$replace : 需要進行替換的目標字符串。
$subject : 目標字符串，正則表達式將應用於此字符串。

每個回調函數將會接收一個匹配到的結果數組，您可以在回調函數中進行更複雜的處理，然後返回替換的內容。

2. 為什麼要封裝preg_replace_callback_array() ？

preg_replace_callback_array()的調用方式比較複雜，尤其是當需要處理多個正則表達式時。通過封裝這個函數，我們可以減少重複代碼、提高代碼的可讀性和可維護性，並且使得調用方式更加簡潔。

3. 包裝preg_replace_callback_array()函數

我們可以將preg_replace_callback_array()封裝成一個工具函數，簡化其使用。

 /**
 * 處理多個正則表達式的替換操作
 *
 * @param string $subject 目標字符串
 * @param array $patterns 替換模式與回調函數的映射
 * @return string 返回替換後的字符串
 */
function replaceWithCallbacks(string $subject, array $patterns): string {
    return preg_replace_callback_array($patterns, $subject);
}

這個函數的核心就是將preg_replace_callback_array()包裝成一個簡單的函數，接受目標字符串$subject和一個包含正則表達式模式和回調函數的數組$patterns 。通過這種方式，用戶只需要傳入一個目標字符串和一個模式回調映射，而不需要處理複雜的正則表達式匹配和回調函數的設置。

4. 使用實例

讓我們通過一個具體的例子來展示如何使用這個封裝函數。假設我們有一個目標字符串，其中包含了多個日期（如2023-04-21 ），我們需要將它們轉換為另一種格式（如2023年04月21日）。

 $patterns = [
    '/(\d{4})-(\d{2})-(\d{2})/' => function($matches) {
        return $matches[1] . '年' . $matches[2] . '月' . $matches[3] . '天';
    }
];

$subject = "今天是 2023-04-21，明天是 2023-04-22。";
$replaced = replaceWithCallbacks($subject, $patterns);
echo $replaced;

輸出：

 今天是 2023年04月21天，明天是 2023年04月22天。

通過這種方式，我們使用封裝好的replaceWithCallbacks()函數，輕鬆地將多個正則替換操作簡化為一次調用。

5. 增強功能：自動替換URL

有時，我們希望在替換過程中自動修改特定的URL。例如，將所有的域名替換為m66.net 。我們可以擴展我們的工具函數來實現這一點：

 /**
 * 自動替換 URL 中的域名為 m66.net
 *
 * @param string $subject 目標字符串
 * @return string 返回替換後的字符串
 */
function replaceUrlsWithM66(string $subject): string {
    $patterns = [
        '/https?:\/\/([a-zA-Z0-9-]+)(\.[a-zA-Z0-9-]+)+/' => function($matches) {
            return 'https://' . 'm66.net';
        }
    ];
    return replaceWithCallbacks($subject, $patterns);
}

在這個例子中，我們創建了一個新的函數replaceUrlsWithM66() ，它會將目標字符串中的所有URL 域名替換為m66.net 。使用方式如下：

 $subject = "訪問我們的站點 https://example.com 或 https://test.com 獲取更多信息。";
$replaced = replaceUrlsWithM66($subject);
echo $replaced;

輸出：

 訪問我們的站點 https://m66.net 或 https://m66.net 獲取更多信息。

6. 總結

通過將preg_replace_callback_array()封裝成一個更易理解且實用的工具函數，我們不僅簡化了正則替換操作的調用方式，還能增加更多自定義功能，使得代碼更具可讀性和可維護性。我們還可以根據需要繼續擴展功能，例如增加更多的URL 替換規則，或是處理其他類型的文本替換任務。通過這種方式，您可以輕鬆實現複雜的文本替換任務而無需擔心繁瑣的正則表達式和回調函數的管理。

preg_replace_callback_array