用於實現簡易模板引擎

M66 2025-05-18

在PHP中， preg_replace_callback_array函數是一個強大的工具，它可以根據正則表達式和回調函數對文本進行處理。通過巧妙地利用這個函數，我們可以實現一個簡易的模板引擎，方便地將變量和邏輯嵌入到HTML模板中。

本文將介紹如何使用preg_replace_callback_array來實現一個簡單的模板引擎，並且我們會示範如何使用該函數替換模板中的佔位符。

一、什麼是preg_replace_callback_array ？

preg_replace_callback_array是PHP 的一個函數，用於執行基於正則表達式的替換操作，並且可以為每個匹配的正則表達式指定一個回調函數。回調函數可以根據匹配的內容進行自定義處理，並返回最終替換的結果。

函數原型如下：

 preg_replace_callback_array(array $patterns_and_callbacks, string $subject);

$patterns_and_callbacks ：一個數組，數組的鍵是正則表達式，值是回調函數。
$subject ：待處理的字符串。

二、構建一個簡易的模板引擎

我們將創建一個簡易的模板引擎，該引擎可以替換模板中的變量並支持簡單的條件邏輯。通過preg_replace_callback_array ，我們可以輕鬆實現這種功能。

1. 準備模板和變量

假設我們有一個簡單的HTML模板，模板中的佔位符用{{}}包裹：

 $template = "<h1>歡迎，{{name}}!</h1><p>{{message}}</p>";
$variables = [
    'name' => '張三',
    'message' => '這是一個簡單的模板引擎示例。',
];

2. 定義替換規則

我們將使用preg_replace_callback_array來定義佔位符的替換規則。我們需要處理兩個主要任務：

替換變量（例如{{name}} ）為實際的值。
處理自定義邏輯，比如根據條件顯示不同的內容。

為了實現這些功能，我們需要構造合適的正則表達式，並為每個正則表達式指定回調函數。

3. 實現模板引擎

以下是實現模板引擎的PHP代碼：

 <?php

$template = "<h1>歡迎，{{name}}!</h1><p>{{message}}</p>";
$variables = [
    'name' => '張三',
    'message' => '這是一個簡單的模板引擎示例。',
];

// 使用 preg_replace_callback_array 實現模板引擎
$patterns_and_callbacks = [
    '/{{(.*?)}}/' => function ($matches) use ($variables) {
        $key = $matches[1];
        return isset($variables[$key]) ? $variables[$key] : '';
    },
];

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

echo $output;

4. 代碼解析

$patterns_and_callbacks數組定義了一個正則表達式/{{(.*?)}}/ ，它匹配模板中的佔位符（例如{{name}} ）。
對於每個匹配到的佔位符，我們通過回調函數將其替換為$variables數組中的實際值。如果找不到相應的變量，回調函數返回一個空字符串。

5. 擴展功能：條件邏輯

為了讓模板引擎更強大，我們可以增加條件語句的支持，例如根據某個條件判斷是否顯示某個內容。我們可以使用類似{{if condition}}的語法來實現這一功能。

下面是一個示例，展示瞭如何在模板中使用簡單的條件判斷：

 <?php

$template = "<h1>歡迎，{{name}}!</h1>{{if show_message}}<p>{{message}}</p>{{endif}}";
$variables = [
    'name' => '張三',
    'message' => '這是一個簡單的模板引擎示例。',
    'show_message' => true, // 控制是否顯示消息
];

// 使用 preg_replace_callback_array 實現模板引擎
$patterns_and_callbacks = [
    '/{{(.*?)}}/' => function ($matches) use ($variables) {
        $key = $matches[1];
        return isset($variables[$key]) ? $variables[$key] : '';
    },
    '/{{if (.*?)}}(.*?){{endif}}/s' => function ($matches) use ($variables) {
        $condition = $matches[1];
        $content = $matches[2];
        // 解析條件並判斷
        if (isset($variables[$condition]) && $variables[$condition]) {
            return $content;
        }
        return '';
    },
];

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

echo $output;

6. 代碼解析

新增了一個正則表達式/{{if (.*?)}}(.*?){{endif}}/s ，用於匹配條件語句。
回調函數檢查{{if condition}}中的條件是否為真。如果為真，則顯示{{message}} ；如果為假，則不顯示任何內容。

三、結論

通過preg_replace_callback_array ，我們可以實現一個非常簡易的模板引擎，處理模板中的變量替換和條件判斷。雖然這個引擎非常基礎，但它展示瞭如何利用正則表達式和回調函數來實現模板引擎的核心功能。你可以在此基礎上擴展更多複雜的功能，比如循環、過濾器、宏定義等，構建一個更為強大的模板引擎。

preg_replace_callback_array