PHP | str_ireplace()函数

str_ireplace() 是 PHP 内置的字符串处理函数，可以用于将字符串中的指定内容进行替换。与 str_replace() 不同的是，str_ireplace() 会忽略大小写。

语法

str_ireplace($search, $replace, $subject, $count = null): string|array|null

• $search : 需要被替换的字符串或字符数组，可以是一个字符串或一个字符串数组，如果是字符串数组，可以同时替换多个内容；
• $replace : 替换 $search 的内容，可以是一个字符串或一个字符串数组，如果是字符串数组，可以与 $search 一一对应，对应位置上的元素会被一一替换；
• $subject : 原字符串，需要被替换的字符串；
• $count : 可选，指定替换的次数，默认是替换所有匹配的情况。

返回值

函数执行成功后，将返回替换后的字符串。

如果 $subject 和 $search 不是字符串或字符数组，则返回 null。

如果 $search 是一个字符串，且 $subject 中不存在该字符串，则返回原字符串 $subject。

如果 $search 是一个字符串数组，且 $replace 不是数组，则将所有 $search 替换成 $replace。

如果 $search 是一个字符串数组，且 $replace 是一个数组，则按顺序，将每个 $search[i] 替换成 $replace[i]。

例子

替换一个字符串

$str = "Hello World";
$new_str = str_ireplace("world", "PHP", $str);

// 输出： Hello PHP
echo $new_str;

替换多个字符串

$str = "Hello World, have a nice day!";
$search = array("world", "nice");
$replace = array("PHP", "great");
$new_str = str_ireplace($search, $replace, $str);

// 输出： Hello PHP, have a great day!
echo $new_str;

限制替换的次数

$str = "Hello World, have a nice day!";
$search = array("world", "nice");
$replace = array("PHP", "great");
$new_str = str_ireplace($search, $replace, $str, $count);

// 输出： Hello PHP, have a great day!
echo $new_str;

// 输出： 2
echo $count;

注意事项

• 如果 $replace 是一个空数组，则 $search 中的元素将被删除；
• 如果 $replace 数组中的元素较少，那么在 $search 中剩余的元素不会被替换；
• 在 $subject 中，替换操作是由左到右进行的；
• 在 $search 和 $replace 数组中，相应的元素是一一对应的，否则会导致替换结果不正确；
• 如果 $search 和 $replace 包含多个元素，应该尽量避免出现元素之间的交叉或覆盖，否则可能得到不正确的结果。