Функция str_replace() — это инструмент для поиска и замены текста в строках. Она позволяет заменить одно или несколько слов, символов или фраз на другие. Применяется для обработки пользовательских данных, генерации шаблонов, фильтрации текста и других задач.
Применение str_replace()
• Замена слов или символов в строке (например, пробелы на подчёркивания)
• Фильтрация нежелательных слов
• Массовая замена нескольких значений
• Обработка шаблонов (подстановка значений)
Синтаксис
str_replace($search, $replace, $subject, &$count)• $search — что ищем (строка или массив)
• $replace — на что заменяем (строка или массив)
• $subject — где ищем и заменяем (строка или массив)
• $count (необязательный) — количество замен (по ссылке)
Возвращаемое значение
• Строка или массив строк с заменами
• Если замен не было — возвращается исходная строка
Примеры использования
1. Простая замена:
$text = "Привет, мир!";
$result = str_replace("мир", "Иван", $text);
// Привет, Иван!2. Замена нескольких слов:
$text = "яблоко, банан, апельсин";
$result = str_replace(["яблоко", "банан"], ["груша", "киви"], $text);
// груша, киви, апельсин3. Замена символов:
$number = "8-800-555-35-35";
$result = str_replace("-", " ", $number);
// 8 800 555 35 354. Подсчёт замен:
$text = "кот, кот, кот";
$count = 0;
$result = str_replace("кот", "пёс", $text, $count);
// $result: пёс, пёс, пёс; $count: 35. Замена в массиве:
$arr = ["яблоко", "банан", "апельсин"];
$result = str_replace("а", "А", $arr);
// ["Яблоко", "бАнАн", "Апельсин"]Важные моменты
• str_replace() не чувствительна к регистру (для чувствительности — str_ireplace())
• Если $replace короче, чем $search (массивы), недостающие элементы заменяются на пустую строку
• Можно использовать для фильтрации символов, например, убрать все пробелы:
str_replace(" ", "", $text);Вывод:
str_replace() — универсальный способ быстро заменить части строки на другие. Подходит для простых и массовых замен, работает с массивами и считает количество замен.