在PHP开发中，替换字符串里的指定内容是高频操作。内置函数str_replace提供了简单直接的实现方式，它不需要正则知识，就能完成固定文本的查找与替换。理解它的参数顺序、数组用法以及返回值特性，能帮你写出更稳妥的字符串处理代码。
一、str_replace函数基本语法
str_replace的函数原型为：mixed str_replace(mixed $search, mixed $replace, mixed $subject, int &$count = null)。其中$search代表要查找的内容，$replace是替换后的内容，$subject是原始字符串或字符串数组，$count是可选的引用参数，用于接收实际发生的替换次数。函数返回替换后的结果，并不会修改原$subject变量。
最基础的用法是三个字符串参数。下面的例子把句子里的“苹果”换成“橙子”：
<?php
$text = '我喜欢吃苹果，苹果很甜';
$result = str_replace('苹果', '橙子', $text);
echo $result;
// 输出：我喜欢吃橙子，橙子很甜
echo $text;
// 原变量不变：我喜欢吃苹果，苹果很甜
?>
从上面可以看出，str_replace是左到右扫描的，并且会替换所有出现的目标串，而不是只换第一个。如果只想替换一次，应考虑用preg_replace加限制，或自己写循环逻辑。
二、使用数组进行批量替换
当我们需要同时替换多个不同内容时，可以把$search和$replace都写成数组。此时PHP会按照索引顺序，将$search数组的第i项替换为$replace数组的第i项。如果两个数组长度不同，多余的搜索项会用空字符串作为替换值，这可能导致意料之外的数据丢失。
看下面这段批量替换代码：
<?php
$search = array('猫', '狗', '鸟');
$replace = array('猫咪', '狗狗');
$text = '公园里有猫、狗和鸟';
$result = str_replace($search, $replace, $text);
echo $result;
// 输出：公园里有猫咪、狗狗和
?>
因为$replace少一个元素，“鸟”被替换成了空串。如果$subject也是数组，str_replace会对数组里的每一个元素都执行相同的替换规则，返回一个同等长度的新数组。
为了避免数组长度不一致带来的隐患，实际项目中建议先校验两个数组长度，或者用循环配对处理，使逻辑更清晰可控。
三、获取替换次数与性能注意点
第四个参数$count非常实用。通过它你能知道一共发生了多少次替换，从而判断内容是否符合预期，比如过滤敏感词时统计命中数量。
<?php
$text = '错误代码A，错误代码B，错误代码A';
$count = 0;
$result = str_replace('错误代码A', 'OK', $text, $count);
echo $result;
// 输出：OK，错误代码B，OK
echo '替换次数：' . $count;
// 输出：替换次数：2
?>
在性能上，str_replace底层使用朴素字符串匹配，对固定文本来说比正则函数快很多。但当$subject非常巨大且替换项极多时，重复扫描也会累积开销。此时可以考虑用strtr函数处理字符映射，或者先拆分再组合来减少遍历。
另外要注意，str_replace区分大小写。若需要不区分大小写，应使用str_ireplace，其参数结构完全一致，只是匹配时忽略字母大小写差异。
四、常见误区与替代方案
不少初学者误以为str_replace能按“单词边界”替换，实际上它只做纯文本序列匹配。例如把“is”替换成“was”，会把“this”里的“is”也一并换掉，变成“thwas”。如果业务要求整词替换，就必须使用正则配合b边界，或先切分单词再判断。
<?php
$text = 'this is a test';
// 错误示范：会破坏this
echo str_replace('is', 'was', $text);
// 输出：thwas was a test
// 正确做法：用正则整词替换
echo preg_replace('/bisb/', 'was', $text);
// 输出：this was a test
?>
总结来看，str_replace适合确定文本、批量替换、追求速度的场景。涉及模式、边界、复杂规则时，应切换到preg_replace等正则工具。理清两者的能力边界，才能写出既高效又准确的PHP字符串处理代码。
PHPstr_replace字符串替换修改时间：2026-08-03 17:12:33