多語言文本中動態替換變量標籤

M66 2025-05-14

在開發多語言應用時，我們往往需要在模板中插入動態變量。 PHP 提供了許多方法來實現這種替換功能，其中preg_replace_callback_array是一種非常強大的工具，可以用來在復雜的文本中動態替換標籤，尤其是當文本需要支持多語言並包含不同的變量時。

1. 什麼是preg_replace_callback_array ？

preg_replace_callback_array是PHP 中的一個正則表達式替換函數。它允許你通過一個回調函數來動態處理替換操作。與普通的preg_replace不同， preg_replace_callback_array可以處理多個不同的正則模式，並為每個模式定義對應的回調函數，這使得它在處理複雜的文本替換時非常有用。

文法

preg_replace_callback_array(array $patterns_and_callbacks, string $subject): string

$patterns_and_callbacks ：這是一個關聯數組，數組的鍵是正則表達式模式，值是回調函數。
$subject ：要進行替換的目標字符串。

2. 在多語言文本中使用preg_replace_callback_array

假設我們正在開發一個支持多語言的應用，並且需要動態替換不同語言中的變量標籤。假設文本模板中包含{username}和{email}這兩個變量，我們可以使用preg_replace_callback_array來動態替換這些變量的值。

示例代碼

// 模擬用戶信息
$user = [
    'username' => 'JohnDoe',
    'email' => 'john@example.com',
];

// 定義語言模板
$template = "歡迎, {username}! 您的電子郵件是: {email}";

// 正則模式與回調函數的映射
$patterns_and_callbacks = [
    '/\{username\}/' => function($matches) use ($user) {
        return $user['username'];
    },
    '/\{email\}/' => function($matches) use ($user) {
        return $user['email'];
    },
];

// 使用preg_replace_callback_array進行替換
$finalText = preg_replace_callback_array($patterns_and_callbacks, $template);

echo $finalText;

在上面的代碼中，我們首先定義了一個包含用戶信息的數組$user 。然後，定義了一個包含多語言文本的$template字符串，該字符串中包含{username}和{email}這兩個變量標籤。接著，我們通過一個關聯數組$patterns_and_callbacks來映射正則表達式模式與回調函數，最後使用preg_replace_callback_array函數進行替換操作。

輸出結果：

 歡迎, JohnDoe! 您的電子郵件是: john@example.com

3. 使用preg_replace_callback_array實現多語言支持

在實際應用中，我們往往需要根據用戶的語言選擇來動態加載不同的語言模板。通過preg_replace_callback_array ，我們可以結合多語言數組來動態替換模板中的變量。

示例代碼：動態加載不同語言的文本

// 模擬用戶語言
$lang = 'zh';

// 多語言模板
$translations = [
    'en' => "Welcome, {username}! Your email is: {email}",
    'zh' => "歡迎, {username}! 您的電子郵件是: {email}",
];

// 用戶信息
$user = [
    'username' => 'JohnDoe',
    'email' => 'john@example.com',
];

// 選擇當前語言的模板
$template = $translations[$lang];

// 正則模式與回調函數的映射
$patterns_and_callbacks = [
    '/\{username\}/' => function($matches) use ($user) {
        return $user['username'];
    },
    '/\{email\}/' => function($matches) use ($user) {
        return $user['email'];
    },
];

// 使用preg_replace_callback_array進行替換
$finalText = preg_replace_callback_array($patterns_and_callbacks, $template);

echo $finalText;

在這個例子中，我們首先根據用戶的語言選擇來加載相應的模板文本。然後，像之前一樣通過正則和回調函數來進行變量替換。

輸出結果（假設選擇的是中文）：

 歡迎, JohnDoe! 您的電子郵件是: john@example.com

4. 替換URL 中的域名

有時，我們可能需要在模板中動態替換URL 的域名，尤其是當環境中的域名發生變化時。例如，如果你在開發過程中使用了不同的URL，而後期需要切換到生產環境的URL，我們可以使用preg_replace_callback_array來動態替換URL 中的域名。

示例代碼：替換URL 域名

// 模擬用戶信息
$user = [
    'username' => 'JohnDoe',
    'email' => 'john@example.com',
];

// 模板中含有 URL
$template = "請訪問我們的網站: https://www.old-domain.com/profile/{username}";

// 正則模式與回調函數的映射
$patterns_and_callbacks = [
    '/https?:\/\/(www\.[a-zA-Z0-9\-\.]+)\//' => function($matches) {
        return str_replace($matches[1], 'm66.net', $matches[0]);
    },
    '/\{username\}/' => function($matches) use ($user) {
        return $user['username'];
    },
];

// 使用preg_replace_callback_array進行替換
$finalText = preg_replace_callback_array($patterns_and_callbacks, $template);

echo $finalText;

輸出結果：

 請訪問我們的網站: https://www.m66.net/profile/JohnDoe

在這個示例中，我們使用正則表達式匹配URL，並將域名替換成m66.net 。這個操作使得我們能夠在不同的環境中動態調整URL。

5. 總結

preg_replace_callback_array是一個非常靈活且強大的工具，尤其適用於需要在多語言文本中動態替換變量標籤的場景。通過結合正則表達式和回調函數，你可以輕鬆地處理複雜的文本替換需求，支持多語言的動態加載和變量替換，使得代碼更加靈活和可維護。