PHP 提供多種字串替換函數,各有適用場景。本文系統比較 str_replace、strtr、substr_replace、preg_replace 的差異、效能與最佳實務。
<?php
// 單一替換
echo str_replace('iwind', 'kiki', 'i love iwind, iwind said');
// 輸出:i love kiki, kiki said
// 多對一:陣列搜尋值 → 單一替換值
echo str_replace(['iwind', 'kiki'], 'people', 'i love kiki, iwind said');
// 輸出:i love people, people said
// 多對多:陣列對陣列(一一對應)
echo str_replace(['iwind', 'kiki'], ['gentle man', 'ladies'], 'i love kiki, iwind said');
// 輸出:i love ladies, gentle man said
// 計算替換次數
$count = 0;
$result = str_replace('a', 'b', 'aaaa', $count);
echo "$result ($count 次)"; // bbbb (4 次)
// 大小寫不敏感版本
echo str_ireplace('WORLD', 'PHP', 'Hello World'); // Hello PHP
?>
<?php
// 用法一:三參數(字元對字元,長度必須相等)
echo strtr('i loves you', 'love', 'LOVE'); // i LOVEs yOu
// 注意:'love'→'LOVE' 是字元對應:l→L, o→O, v→V, e→E
// 'you' 中的 o 被替換為 O,v 替換為 V,e 替換為 E
// 用法二:二參數 關聯陣列(子串對子串,長度可不同)⭐ 推薦
$trans = [
'you' => 'her sister',
'love' => 'hate',
];
echo strtr('i love you', $trans); // i hate her sister
// 關鍵差異:strtr 以「最長匹配優先」且「不重複掃描已替換部分」
$trans2 = ['ab' => 'X', 'bc' => 'Y'];
echo strtr('abc', $trans2); // Xc (ab→X, 剩 c)
// str_replace 會依陣列順序依序掃描,可能產生不同結果
?>
strtr 針對固定對照表優化,大量替換時比 str_replace 快 2-4 倍strtr 三參數版本僅限單字元對應,易誤用strtr($str, $map);動態、單次替換用 str_replace<?php
$str = 'abcdefgh';
// 從位置 3 開始替換到結尾
echo substr_replace($str, 'XYZ', 3); // abcXYZ
// 從位置 3 替換 2 字元
echo substr_replace($str, 'XYZ', 3, 2); // abcXYZfgh
// 負數位置:從結尾算起
echo substr_replace($str, 'XYZ', -3); // abcdeXYZ
echo substr_replace($str, 'XYZ', -3, 2); // abcdeXYh
// 批次替換(陣列參數)
$arr = ['abcdef', '123456'];
echo implode(', ', substr_replace($arr, 'X', 2, 2)); // abXef, 12X56
?>
<?php
// 移除所有非字母數字
echo preg_replace('/[^a-zA-Z0-9]/', '', 'a1-b2_c3!'); // a1b2c3
// 回調函數替換:將數字乘 2
echo preg_replace_callback('/\d+/', fn($m) => $m[0] * 2, '價格 100 元'); // 價格 200 元
// 限制替換次數
echo preg_replace('/\s+/', '-', 'a b c', 1); // a-b c (只替換第一處)
// 修飾符 e (PREG_REPLACE_EVAL) 已移除(PHP 7.0+),改用 preg_replace_callback
?>
<?php
$str = 'abcdefghijklmnopqrstuvwxyz';
$map = array_combine(range('a','z'), range('A','Z'));
$t = hrtime(true);
for ($i=0;$i<1_000_000;$i++) strtr($str, $map);
echo "strtr: " . (hrtime(true)-$t)/1e6 . " ms\n"; // ~180 ms
$t = hrtime(true);
for ($i=0;$i<1_000_000;$i++) str_replace(array_keys($map), array_values($map), $str);
echo "str_replace: " . (hrtime(true)-$t)/1e6 . " ms\n"; // ~420 ms
$t = hrtime(true);
for ($i=0;$i<1_000_000;$i++) preg_replace('/[a-z]/', fn($m)=>strtoupper($m[0]), $str);
echo "preg_replace_callback: " . (hrtime(true)-$t)/1e6 . " ms\n"; // ~1200 ms
?>
| 需求 | 推薦函數 | 理由 |
|---|---|---|
| 固定詞彙字典替換(多對多) | strtr($str, $map) | 最快、最長匹配優先、不重複掃描 |
| 單一/少量動態替換 | str_replace() | 語法簡單、可統計次數、支援陣列 |
| 指定位置/長度替換 | substr_replace() | 精確控制位置 |
| 模式匹配替換(正則) | preg_replace() / preg_replace_callback() | 功能最強、可運算替換內容 |
| 大小寫不敏感替換 | str_ireplace() | 內建忽略大小寫 |
字串替換沒有銀彈,依需求選擇:字典替換用 strtr、一般替換用 str_replace、位置替換用 substr_replace、模式替換用 preg_replace。記住 strtr 的「最長匹配優先」特性,能避免許多邏輯 Bug。