The str_replace() function returns a string with occurrences of a specified substring replaced by another string. The function can operate on scalar strings or arrays.


str_replace($search, $replace, $base, $count)
  • $search is the string being searched for in $base. It can be a string or an array. If it’s an array, each element will be searched for in turn.
  • $replace is the string used for replacing the $search term. If $search and $replace are arrays, each $search item will be replaced by the corresponding item in $replace. If $replace items run out, then an empty string will be used for remaining values. If $search is an array and $replace is a string, then the $replace value will be used for all $search items.
  • $base is the string(s) being searched. If it is an array, the replacements will be made to every string in the array, and the function will return an array of the modified strings.
  • $count is an optional int. If included, it will be set to the number of replacements performed.

Codebyte Example

This example provides three demonstrations of str_replace() operating on a string.



Interested in helping build Docs? Read the Contribution Guide or share your thoughts in this feedback form.

Learn PHP on Codecademy