str_replace是字面批量替换的默认选择,快且兼容性好;strtr有两种用法:双参数为逐字符映射,关联数组为子串优先替换;preg_replace仅用于动态模式匹配。

str_replace 是字面批量替换的默认选择
绝大多数场景下,str_replace() 就是你该用的函数——它快、稳、兼容 PHP 4 起所有版本,底层是 C 实现的线性扫描。参数顺序必须是 str_replace($search, $replace, $subject),传反了会静默返回原串或 null。
支持数组批量操作:str_replace(['old1', 'old2'], ['new1', 'new2'], $text),按索引对齐;想统计次数?传第四个引用参数:$count = 0; str_replace('x', 'y', $s, $count);;忽略大小写直接换 str_ireplace(),PHP 8.2 已不依赖 setlocale(),ASCII 范围内更可靠。
常见错误现象:
- 搜索项之间有包含关系(如
['ab', 'abc']),前面替换完生成的新内容可能被后续规则再次匹配,造成意料外结果 - 在循环里反复调用,且
$subject很长但实际无需替换——str_replace()每次都会分配内存扫描全串,白白浪费 - 处理含中文文本时没加
mb_*前缀,导致位置错乱或截断
strtr 的两种用法行为完全不同,别混用
strtr($text, $from, $to) 和 strtr($text, $map) 看似同名,实则逻辑割裂:前者是「逐字符映射」,后者是「子串优先替换」。前者容易误伤,后者才是安全可用的模式。
比如 strtr("I Love you", "Lo", "lO") 输出 I lOve yOu,因为 L→l、o→O 是独立作用在每个字符上的,不是把 "Lo" 当整体换掉。而 strtr("I Love you", ["Love" => "hate"]) 才真正按子串替换,输出 I hate you。
关键限制:
-
strtr($text, $from, $to)中,若$from或$to长度为 0,会触发警告,且不执行替换 -
strtr($text, $map)中,键不能是空字符串,值为空字符串合法(即删除对应子串) - 所有替换都基于原始字符串,不会发生“链式替换”——这点和
str_replace()的顺序执行不同
性能差异取决于 PHP 版本和使用方式
网上流传“strtr() 比 str_replace() 快 4 倍”只在特定条件下成立:PHP 7+ 且使用关联数组形式 strtr($text, $map),同时替换规则满足“一对一、无重叠、短子串为主”。但在 PHP 5.6 下,实测 str_replace() 反而快 10 倍以上。
真正影响性能的关键点:
- 用
strtr($text, $map)替代str_replace()批量单字符转义(如 URL 安全 Base64 映射),能提效 2–4 倍 - 用
strtr($text, "abc", "xyz")这种双参数形式,不仅语义不清、易出错,而且在 PHP 7+ 中性能也不占优 - 如果只是单次字面替换,两者差距在 0.1% 左右,可忽略;但若先用
strpos()判断是否存在再决定是否调用替换函数,不替换时能快 200%
什么时候该用 preg_replace()?仅当必须匹配模式
preg_replace() 是唯一能处理“所有邮箱”“连续数字”“HTML 标签”这类动态模式的函数。但它有明确代价:PCRE2 引擎编译 + 回溯开销仍在,纯字面替换比 str_replace() 慢 3–10 倍。
务必注意:
- 用户输入进正则前,必须用
preg_quote($user_input, '/')转义,否则可能被注入恶意模式 - 只替换一次就加限制参数:
preg_replace('/pattern/', 'to', $s, 1) - 大小写不敏感用
i修饰符:/hello/i,别自己模拟逻辑 - 别在循环里反复调用它处理同一段文本——要么预编译模式,要么改用其他方案
最常被忽略的一点:很多人以为 strtr() 天然支持中文,其实它按字节操作,遇到 UTF-8 多字节字符时,若用双参数形式,会把一个汉字拆成多个字节分别映射,结果完全不可控。涉及中文,只信任 strtr($text, $map) 形式,并确保键值都是完整 Unicode 字符串。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











