PHP str_replace 陣列參數深度解析：五種組合場景全測試與最佳實踐

函數原型回顧

mixed str_replace ( mixed $search, mixed $replace, mixed $subject [, int &$count ] )

三個核心參數 $search、$replace、$subject 均接受字符串或陣列，組合出 2³=8 種情況（含純字符串）。本文深度測試五種典型陣列組合場景。

場景測試與結果分析

基準：純字符串模式

str_replace("m", "n", "my name is jim!");
// 返回："ny nane is jin!"

1. 僅 $search 為陣列

str_replace(['m', 'i'], 'n', "my name is jim!");
// 返回："ny nane ns jnn!"

規則：依次用同一個 $replace 替換 $search 中每個元素。順序執行，先替換 'm' 再替換 'i'。

2. 僅 $replace 為陣列 ⚠️ 陷阱

str_replace('m', ['n', 'z'], "my name is jim!");
// 返回："Arrayname is jiArray!"

關鍵發現：當 $replace 為陣列但 $search 為字符串時，PHP 將整個陣列轉為字符串 "Array" 進行替換！此行為幾無實用價值，極易產生 Bug。

3. 僅 $subject 為陣列

str_replace("m", "n", ["my name is jim!", "the game is over!"]);
// 返回：["ny nane is jin!", "the game is over!"]

規則：對陣列中每個字符串獨立執行替換，返回結果陣列。結構保持一致。

4. $search 和 $replace 皆為陣列

// 等長陣列：一一對應替換
str_replace(['m', 'i'], ['n', 'z'], "my name is jim!");
// 返回："ny nane zs jzn!"

// $search 較長：多出元素替換為空字符串
str_replace(['m', 'i', 's'], ['n', 'z'], "my name is jim!");
// 返回："ny nane z jzn!"  （'s' 被替換為 ''）

// $replace 較長：多出元素被忽略
str_replace(['m', 'i'], ['n', 'z', 'x'], "my name is jim!");
// 返回："ny nane zs jzn!"  （'x' 無效）

核心規則：按索引一一對應。$search 多 → 空字符串填補；$replace 多 → 忽略。

5. 三參數皆為陣列

str_replace(
    ['m', 'i'], 
    ['n', 'z'], 
    ["my name is jim!", "the game is over"]
);
// 返回：["ny nane zs jzn!", "the gane zs over"]

規則：對 $subject 每個元素，應用相同的 $search→$replace 映射規則。

總結對比表

最佳實踐與避坑指南

1. 永不單獨傳陣列給 $replace：無實際意義，極易誤用
2. 批量替換映射請用關聯陣列 + 循環：

   $map = ['m' => 'n', 'i' => 'z', 's' => '$'];
   $str = "my name is jim!";
   foreach ($map as $k => $v) {
       $str = str_replace($k, $v, $str);
   }
   // 結果可控、邏輯清晰

3. 大規模替換考慮 strtr()：單字符映射更快，且無順序依賴問題
4. 需要計數時使用第 4 參數：str_replace($s, $r, $subj, $count)

結語

str_replace 陣列參數行為看似靈活，實則暗藏陷阱（特別是場景 2）。生產代碼中，顯式循環 + 關聯映射 比依賴內置陣列語義更安全、更易維護、更易調試。