Как работает функция str replace в php?

str_replace — Заменяет все вхождения строки поиска на строку замены.

str_replace(
    array|string $search,
    array|string $replace,
    string|array $subject,
    int &$count = null
): string|array

Данная функция принимает три аргумента. Первым параметром является строка для поиска $search, вторым параметром является строка для замены $replace, а третьим параметром является строка или массив $subject, в котором выполняется поиск. Функция возвращает строку или массив с вашими изменениями.

Подробней можно прочитать в документации php.net