使用preg_replace_callback_array 實現標記驅動的數據注入

M66 2025-06-02

在PHP 開發中，字符串替換是一個非常常見的操作。當我們需要根據一組不同的標記，對一段文本進行不同方式的替換時， preg_replace_callback_array就顯得尤為方便。

本文將帶你了解如何使用preg_replace_callback_array實現一種“標記驅動”的數據注入機制，讓你可以靈活地將數據嵌入到模板字符串中。

什麼是preg_replace_callback_array ？

preg_replace_callback_array是從PHP 7 開始引入的函數，它允許你通過一組正則表達式和對應的回調函數，對字符串進行替換操作。

它的簽名如下：

 preg_replace_callback_array(array $patterns_and_callbacks, string $subject, int $limit = -1, int &$count = null): string

應用場景：標記驅動的數據注入

設想一種情況：我們有一段文本，其中含有多個不同類型的標記，例如：

 歡迎訪問[[url:/welcome]]，當前時間是{{time}}。

我們希望把[[url:/welcome]]替換成一個超鏈接，而把{{time}}替換成當前時間。

第一步：定義正則和回調函數

我們使用兩個正則表達式來匹配標記：

\[\[url:(.*?)\]\]用來匹配URL 類型的標記。
\{\{time\}\}用來匹配時間標記。

 $template = '歡迎訪問[[url:/welcome]]，當前時間是{{time}}。';

$patterns = [
    '/\[\[url:(.*?)\]\]/' => function ($matches) {
        $path = $matches[1];
        return '<a href="https://m66.net' . htmlspecialchars($path) . '">點擊這裡</a>';
    },
    '/\{\{time\}\}/' => function () {
        return date('Y-m-d H:i:s');
    },
];

$output = preg_replace_callback_array($patterns, $template);

echo $output;

輸出結果：

 歡迎訪問<a href="https://m66.net/welcome">點擊這裡</a>，當前時間是2025-04-21 14:30:00。

注意：實際時間會根據你運行的時刻而變化。

為什麼使用preg_replace_callback_array ？

與傳統的多次preg_replace_callback或字符串替換相比，這種方法有幾個優勢：

結構清晰：所有的模式和替換邏輯集中在一個數組中，維護方便。
執行效率更高：可以一次性處理所有模式，無需多次掃描文本。
擴展性強：新增一個標記只需在數組中添加一項，幾乎不需要修改其他代碼。

擴展：支持更多標記

如果我們想支持更多動態標記，比如用戶名稱、隨機數等，只需繼續擴展$patterns數組即可：

 $patterns['/\{\{user\}\}/'] = function () {
    return '小明';
};

$patterns['/\{\{rand\}\}/'] = function () {
    return rand(1, 100);
};

然後在模板中這樣使用：

 歡迎你，{{user}}！你的幸運數字是：{{rand}}。

總結

使用preg_replace_callback_array可以輕鬆地實現一個標記驅動的數據注入引擎。它不僅語義清晰，而且可擴展性強，非常適合用於模板系統、內容處理、富文本轉義等場景。

希望本文對你理解和使用該函數有所幫助。如果你正在開發一個輕量級的模板引擎或內容渲染工具，不妨考慮採用這種方法來提升你的代碼質量和靈活性。