php str_replace函数 PHP str_replace() 函数

php str_replace函数

PHP str_replace函数是一个用于替换字符串中的字符的函数，它可以将一个字符串中的某些字符替换成另外一些字符。它是PHP中最常用的字符串函数之一，也是最实用的。

str_replace函数有三个参数：要被替换的字符，要用来替换的字符，以及要被处理的字符串。它会在输入的字符串中寻找要被替换的字符，然后将其替换成要用来替代它们的新字符。

$str = "Hello World!"; 
$newstr = str_replace("World", "PHP", $str); 
echo $newstr; // 输出 Hello PHP! 

除了上面这样使用单独的单词作为参数外，我们还可以使用数组作为参数。在这里，我们将使用一个包含多个单词和相应单词作为参数来让 str_replace 函数执行批量处理。

 
$words = array("Hello", "World"); 
$replacements = array("Hi", "PHP"); 
$str = "Hello World!"; 
$newstr = str_replace($words, $replacements, $str); 
echo $newstr; // 输出 Hi PHP! 

PHP str_replace() 函数

PHP str_replace() 函数

PHP String 参考手册

实例

把字符串 "Hello world!" 中的字符 "world" 替换成 "Peter"：

<?php
echo str_replace("world","Peter","Hello world!");
?>

运行实例 »

---

定义和用法

str_replace() 函数替换字符串中的一些字符（区分大小写）。

该函数必须遵循下列规则：

• 如果搜索的字符串是一个数组，那么它将返回一个数组。
• 如果搜索的字符串是一个数组，那么它将对数组中的每个元素进行查找和替换。
• 如果同时需要对某个数组进行查找和替换，并且需要执行替换的元素少于查找到的元素的数量，那么多余的元素将用空字符串进行替换。
• 如果是对一个数组进行查找，但只对一个字符串进行替换，那么替代字符串将对所有查找到的值起作用。

注释：该函数是区分大小写的。请使用 str_ireplace() 函数执行不区分大小写的搜索。

注释：该函数是二进制安全的。

---

语法

str_replace(find,replace,string,count)

参数	描述
find	必需。规定要查找的值。
replace	必需。规定替换 find 中的值的值。
string	必需。规定被搜索的字符串。
count	可选。一个变量，对替换数进行计数。

技术细节

返回值：	返回带有替换值的字符串或数组。
PHP 版本：	4+
更新日志：	在 PHP 5.0 中，新增了 count 参数。 在 PHP 4.3.3 之前，该函数的 find 和 replace 参数都为数组时将会遇到麻烦，会引起空的 find 索引在内部指针没有更换到 replace 数组上时被忽略。新的版本不会有这个问题。 自 PHP 4.0.5 起，大多数参数可以是一个数组。

---

更多实例

实例 1

使用带有数组和 count 变量的 str_replace() 函数：

<?php
$arr = array("blue","red","green","yellow");
print_r(str_replace("red","pink",$arr,$i));
echo "Replacements: $i";
?>

运行实例 »

实例 2

使用带有需要替换的元素少于查找到的元素的 str_replace() 函数：

<?php
$find = array("Hello","world");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_replace($find,$replace,$arr));
?>

运行实例 »

---

PHP String 参考手册