str_replace ( mixed $search, mixed $replace, mixed $subject, int &$count = ? ) : mixed
它是最常用的字符串替换函数,默认区分大小写。如果希望不区分大小写,可以使用 str_ireplace。
〓 参数可以是数组,实现批量替换。很多网友关心“如何一次替换多个关键词”——这正是数组参数的妙用。
当 $search 和 $replace 都是数组时,对应位置元素逐一替换。如果 $replace 元素少于 $search,多余的 $search 会被替换为空字符串。
⚡ 网友们还关心:如果 $replace 只有一个值,而 $search 有多个,则所有 $search 都被替换成同一个值。
很多开发者遇到 str_replace 对中文“无效”或出现乱码。实际上只要 UTF-8 编码统一,替换完全正常。但要注意 mb_* 函数处理多字节时的差异。
※ 如果出现替换失败,先检查文件编码与字符串编码是否一致。 str_replace 是二进制安全的。
很多手册一笔带过,但这是实用技巧:传入一个变量,替换完成后 $count 会被赋值为替换发生的次数。
〓 常用于统计敏感词出现频率、或验证替换是否生效。
str_replace 是纯字符串操作,速度远快于正则。在简单替换场景,优先使用 str_replace。但需要模式匹配(如替换所有数字)则必须用 preg_replace。
► 网友实测:替换10000次简单字符串,str_replace 耗时约 0.002秒,preg_replace 约 0.015秒。
► 建议:不需要正则时,永远选 str_replace。
很多场景需要将 \n 或 \r\n 替换为
或空格。直接使用 str_replace 即可:
〓 注意顺序:先替换 \r\n 再替换 \n,避免重复替换。网友们还关心“保留空行”的问题,可以通过替换为 实现。
➤ 进阶:使用 nl2br() 更直观,但 str_replace 给予更多控制。
str_replace 区分大小写。例如 str_replace('PHP','php','Php is cool') 不会替换。这时应使用 str_ireplace。
〓 性能上 str_ireplace 略慢于 str_replace,但差别可忽略。如果项目需要大量不区分大小写替换,建议统一小写后替换。
⚙️ 网友常见误区:认为 str_replace 可以接受正则,其实不行,别混淆。
当 $subject 是数组时,str_replace 会遍历数组的值进行替换,键名保持不变。但注意:如果替换发生在键名上?不,它只替换值。
〓 如果想替换键名,需用 array_combine 或其他循环。网友们还关心“多维数组替换”,str_replace 不会递归,需配合 array_walk_recursive。
很多简易模板系统使用 str_replace 替换变量占位符,例如 {title} 替换为实际内容。虽然不如编译型引擎高效,但对于小型项目足够。
{content}
";⚡ 注意:如果占位符有重叠,长的占位符应放在前面替换。
搜索结果中高亮关键词,常使用 str_replace 将关键词替换为带 的版本。但要注意XSS,先转义再替换。
➤ 网友们还关心“高亮多个词”,可用数组参数一次完成。
将 .htm 链接全部改为 .html,同时保留其他部分。
〓 更稳健:使用正则或 str_replace 配合精确匹配。
将敏感词替换为同长度的星号,利用 str_repeat 动态生成。
⚡ 网友们还关心“部分屏蔽”,如保留首字,可自定义替换逻辑。
类似 [b]text[/b] 转 text,用 str_replace 成对替换。
➤ 嵌套复杂时建议用 preg_replace,但简单场景 str_replace 足够。
完全可以,只要编码一致(推荐UTF-8)。很多网友遇到替换失败,通常是因为文件编码是GBK而字符串是UTF-8。使用 mb_convert_encoding 统一即可。
str_replace 返回新数组/字符串,原变量不变(除非使用引用传参的 $count)。如果需要修改原变量,请重新赋值。
检查是否因为重叠替换。例如将 "aa" 替换为 "a",则 "aaa" 只会替换一次(变为 "aa")。str_replace 从左到右,不重新检查已替换部分。
直接写转义序列即可,例如 str_replace("\\n", "
", $str)。注意双引号内转义。
〓 更多深度解析:str_replace 与 preg_replace 在大型项目中的选型建议、str_replace 与 strtr 性能对比(strtr 在某些场景更快)。网友们还关心“如何替换任意空白字符”,此时需结合正则或 trim。