⚙️ php str_replace · 攻略

〈 php str_replace 〉核心精讲 参数·行为·陷阱

【①】函数签名与基础用法

str_replace ( mixed $search, mixed $replace, mixed $subject, int &$count = ? ) : mixed

它是最常用的字符串替换函数,默认区分大小写。如果希望不区分大小写,可以使用 str_ireplace。

// 简单替换
$str = "Hello php, php is powerful";
echo str_replace("php", "PHP", $str);
// 结果: Hello PHP, PHP is powerful

〓 参数可以是数组,实现批量替换。很多网友关心“如何一次替换多个关键词”——这正是数组参数的妙用。

【②】批量替换数组模式

当 $search 和 $replace 都是数组时,对应位置元素逐一替换。如果 $replace 元素少于 $search,多余的 $search 会被替换为空字符串。

$search = ['http://', 'www.'];
$replace = ['https://', 'web.'];
$subject = 'http://www.xservx.com';
echo str_replace($search, $replace, $subject);
// https://web.xservx.com

⚡ 网友们还关心:如果 $replace 只有一个值,而 $search 有多个,则所有 $search 都被替换成同一个值。

【③】中文替换与编码陷阱

很多开发者遇到 str_replace 对中文“无效”或出现乱码。实际上只要 UTF-8 编码统一,替换完全正常。但要注意 mb_* 函数处理多字节时的差异。

$text = '〖php〗字符串替换〖中文〗';
echo str_replace('〖中文〗', '【chinese】', $text);
// 〖php〗字符串替换【chinese】

※ 如果出现替换失败,先检查文件编码与字符串编码是否一致。 str_replace 是二进制安全的。

〔 进阶 〕引用计数 · 性能 · 与 regex 对比 深度参数

⑩ 第四个参数 $count 引用传递

很多手册一笔带过,但这是实用技巧:传入一个变量,替换完成后 $count 会被赋值为替换发生的次数。

$str = "one two one three one";
$count = 0;
$result = str_replace('one', '1', $str, $count);
echo $count; // 输出 3

〓 常用于统计敏感词出现频率、或验证替换是否生效。

⚡ 性能:str_replace vs preg_replace

str_replace 是纯字符串操作,速度远快于正则。在简单替换场景,优先使用 str_replace。但需要模式匹配(如替换所有数字)则必须用 preg_replace。

► 网友实测:替换10000次简单字符串,str_replace 耗时约 0.002秒,preg_replace 约 0.015秒。

► 建议:不需要正则时,永远选 str_replace。

⏎ 如何用 str_replace 替换换行符?

很多场景需要将 \n 或 \r\n 替换为
或空格。直接使用 str_replace 即可:

$text = "line1\nline2\r\nline3";
// 统一替换为
$result = str_replace(["\r\n", "\n"], "
", $text);
echo $result;

〓 注意顺序:先替换 \r\n 再替换 \n,避免重复替换。网友们还关心“保留空行”的问题,可以通过替换为

实现。

➤ 进阶:使用 nl2br() 更直观,但 str_replace 给予更多控制。

Ⓐ 大小写敏感?str_ireplace 来帮忙

str_replace 区分大小写。例如 str_replace('PHP','php','Php is cool') 不会替换。这时应使用 str_ireplace。

echo str_ireplace('PHP', 'php', 'Php is cool, PHP7');
// 结果: php is cool, php7

〓 性能上 str_ireplace 略慢于 str_replace,但差别可忽略。如果项目需要大量不区分大小写替换,建议统一小写后替换。

⚙️ 网友常见误区:认为 str_replace 可以接受正则,其实不行,别混淆。

⑶ 替换数组键值?小心键名丢失

当 $subject 是数组时,str_replace 会遍历数组的值进行替换,键名保持不变。但注意:如果替换发生在键名上?不,它只替换值。

$arr = ['name' => 'php', 'version' => '8.2'];
$replaced = str_replace('php', 'PHP', $arr);
// 结果: ['name' => 'PHP', 'version' => '8.2']

〓 如果想替换键名,需用 array_combine 或其他循环。网友们还关心“多维数组替换”,str_replace 不会递归,需配合 array_walk_recursive。

〔 网友们还关心 〕热点周边 高频搜索延伸

☆ str_replace 与 模板引擎

很多简易模板系统使用 str_replace 替换变量占位符,例如 {title} 替换为实际内容。虽然不如编译型引擎高效,但对于小型项目足够。

$tpl = "

{title}

{content}

";
$vars = ['{title}'=>'攻略', '{content}'=>'str_replace实战'];
echo str_replace(array_keys($vars), array_values($vars), $tpl);

⚡ 注意:如果占位符有重叠,长的占位符应放在前面替换。

◎ str_replace 与 数据库关键词高亮

搜索结果中高亮关键词,常使用 str_replace 将关键词替换为带 的版本。但要注意XSS,先转义再替换。

$safe = htmlspecialchars($text, ENT_QUOTES);
$highlight = str_replace($keyword, "$keyword", $safe);

➤ 网友们还关心“高亮多个词”,可用数组参数一次完成。

  • ① 替换URL参数 用 str_replace 修改 query 部分,但注意要精确匹配,避免破坏其他参数。
  • ② 清理用户输入 过滤敏感词:str_replace 配合黑名单数组,但建议用 str_ireplace 忽略大小写。
  • ③ 替换命名空间 批量替换 App\Old 为 App\New,注意反斜杠转义。
  • ④ 与 substr_replace 区别 substr_replace 按位置替换,而 str_replace 按内容。

〖 实战案例 〗 str_replace 在真实项目中的运用

〔案例·A〕 批量替换文件后缀

将 .htm 链接全部改为 .html,同时保留其他部分。

$html = 'click here';
echo str_replace('.htm"', '.html"', $html);
// 注意加引号防止误伤

〓 更稳健:使用正则或 str_replace 配合精确匹配。

〔案例·B〕 敏感词过滤(带星号)

将敏感词替换为同长度的星号,利用 str_repeat 动态生成。

$bad = ['坏词', '敏感'];
$replace = array_map(fn($w)=>str_repeat('*', mb_strlen($w)), $bad);
echo str_replace($bad, $replace, $text);

⚡ 网友们还关心“部分屏蔽”,如保留首字,可自定义替换逻辑。

〔案例·C〕 动态模板短代码

类似 [b]text[/b] 转 text,用 str_replace 成对替换。

$bbcode = '[b]加粗[/b]';
$bbcode = str_replace(['[b]','[/b]'], ['',''], $bbcode);

➤ 嵌套复杂时建议用 preg_replace,但简单场景 str_replace 足够。

〔 FAQ 〕 网民高频疑问 深度解答

❓ str_replace 能替换中文吗?

完全可以,只要编码一致(推荐UTF-8)。很多网友遇到替换失败,通常是因为文件编码是GBK而字符串是UTF-8。使用 mb_convert_encoding 统一即可。

❓ 替换后原数组会改变吗?

str_replace 返回新数组/字符串,原变量不变(除非使用引用传参的 $count)。如果需要修改原变量,请重新赋值。

❓ 为什么 str_replace 替换次数比预期少?

检查是否因为重叠替换。例如将 "aa" 替换为 "a",则 "aaa" 只会替换一次(变为 "aa")。str_replace 从左到右,不重新检查已替换部分。

❓ 如何替换转义字符?

直接写转义序列即可,例如 str_replace("\\n", "
", $str)
。注意双引号内转义。

〓 更多深度解析:str_replace 与 preg_replace 在大型项目中的选型建议、str_replace 与 strtr 性能对比(strtr 在某些场景更快)。网友们还关心“如何替换任意空白字符”,此时需结合正则或 trim。