PHP str_ireplace() Function

❮ PHP String Reference


Replace the characters "WORLD" (case-insensitive) in the string "Hello world!" with "Peter":

echo str_ireplace("WORLD","Peter","Hello world!");
Run example »

Definition and Usage

The str_ireplace() function replaces some characters with some other characters in a string.

This function works by the following rules:

  • If the string to be searched is an array, it returns an array
  • If the string to be searched is an array, find and replace is performed with every array element
  • If both find and replace are arrays, and replace has fewer elements than find, an empty string will be used as replace
  • If find is an array and replace is a string, the replace string will be used for every find value

Note: This function is case-insensitive. Use the str_replace() function to perform a case-sensitive search.

Note: This function is binary-safe.



Parameter Description
find Required. Specifies the value to find
replace Required. Specifies the value to replace the value in find
string Required. Specifies the string to be searched
count Optional. A variable that counts the number of replacements

Technical Details

Return Value: Returns a string or an array with the replaced values
PHP Version: 5+
Changelog: The count parameter was added in PHP 5.0

More Examples

Example 1

Using str_ireplace() with an array and a count variable:

$arr = array("blue","red","green","yellow");
print_r(str_ireplace("RED","pink",$arr,$i)); // This function is case-insensitive
echo "Replacements: $i";
Run example »

Example 2

Using str_ireplace() with fewer elements in replace than find:

$find = array("HELLO","WORLD");
$replace = array("B");
$arr = array("Hello","world","!");
Run example »

❮ PHP String Reference