萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 字串替換完全指南:str_replace、strtr、substr_replace、preg_replace

前言

PHP 提供多種字串替換函數,各有適用場景。本文系統比較 str_replace、strtr、substr_replace、preg_replace 的差異、效能與最佳實務。

1. str_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
?>

特性

  • ✅ 二進位安全
  • ✅ 支援陣列搜尋/替換
  • ✅ 可統計替換次數
  • ❌ 不支援正則、不支援位置/長度控制
  • ❌ 大量替換時記憶體佔用較大(內部建立中間陣列)

2. strtr():字元/子串對照表替換,速度最快

<?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 vs str_replace 效能

  • strtr 針對固定對照表優化,大量替換時比 str_replace 快 2-4 倍
  • 但 strtr 三參數版本僅限單字元對應,易誤用
  • 建議:固定詞彙替換字典用 strtr($str, $map);動態、單次替換用 str_replace

3. substr_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
?>

4. preg_replace():正則表達式替換,功能最強

<?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
?>

效能比較(100 萬次循環,PHP 8.2)

<?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。

copyright © 萬盛學電腦網 all rights reserved