Функция str_replace() в PHP — это мощный инструмент для обработки строк, позволяющий заменять вхождения определённых подстрок другими. Она незаменима при очистке данных, форматировании текста и множестве других задач. В этой статье мы разберём str_replace() подробно, с примерами и пояснениями, которые помогут даже начинающим разработчикам освоить её возможности.

Что делает str_replace()?

В самом простом случае str_replace() заменяет все вхождения одной строки на другую в заданной строке. Например, если нужно заменить все вхождения слова "кот" на "собака", то str_replace() идеально подходит для этой задачи. Однако, возможности функции выходят далеко за рамки простого поиска и замены.

Синтаксис:

Функция имеет следующий синтаксис:

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

Разберём каждый параметр:

* $search: Это строка или массив строк, которые нужно найти в $subject. Если это массив, то функция будет искать и заменять каждый элемент этого массива.

* $replace: Это строка или массив строк, которые будут использованы для замены найденных значений $search. Если это массив, он должен быть той же длины, что и $search. Если он короче, то оставшиеся элементы $search будут заменены пустыми строками. Важно понимать, что тип mixed означает, что $search и $replace могут быть как строками, так и массивами строк. Функция гибко обрабатывает различные комбинации.

* $subject: Это строка или массив строк, в котором будет происходить поиск и замена. Если это массив, то функция обработает каждый элемент массива.

* $count (необязательный): Переменная, которая по ссылке принимает количество произведенных замен. Это полезно, если вам нужно знать, сколько замен было выполнено.


Примеры:

1. Простая замена:

<?php

$string = "Привет, мир!";

$newString = str_replace("мир", "PHP", $string);

echo $newString; // Выведет: Привет, PHP!

?>

В этом примере мы заменяем "мир" на "PHP".

2. Замена с использованием массивов:

<?php

$search = array("кот", "собака");

$replace = array("пес", "кошка");

$string = "У меня есть кот и собака.";

$newString = str_replace($search, $replace, $string);

echo $newString; // Выведет: У меня есть пес и кошка.

?>

Здесь мы заменяем "кот" на "пес" и "собака" на "кошка" одновременно.

3. Замена с неравной длиной массивов:

<?php

$search = array("кот", "собака", "птица");

$replace = array("пес", "кошка");

$string = "У меня есть кот, собака и птица.";

$newString = str_replace($search, $replace, $string);

echo $newString; // Выведет: У меня есть пес, кошка и .



// Объяснение:

// "кот" заменяется на "пес"

// "собака" заменяется на "кошка"

// "птица" остаётся без изменений, т.к. в массиве $replace нет соответствующего элемента.

?>

Обратите внимание, что "птица" осталась незамеченной, так как в $replace меньше элементов, чем в $search.

4. Подсчёт количества замен:

<?php

$string = "Это строка с несколькими словами строка.";

$count = 0;

$newString = str_replace("строка", "предложение", $string, $count);

echo "Количество замен: " . $count; // Выведет: Количество замен: 2

?>

Переменная $count теперь содержит количество замен. Этот параметр передается *по ссылке* (&$count), поэтому изменение его значения внутри функции влияет на переменную, переданную в функцию.

5. Замена в массиве:

<?php

$array = array("Привет, мир!", "Ещё один мир!");

$newArray = str_replace("мир", "PHP", $array);

print_r($newArray);

// Выведет: Array ( [0] => Привет, PHP! [1] => Ещё один PHP! )

?>

str_replace() корректно работает и с массивами строк.

6. Обработка специальных символов (Пример с обратной косой чертой):

<?php

$string = "C:\path\to\file";

$newString = str_replace("\", "/", $string);

echo $newString; // Выведет:C:/path/to/file

?>

7. Сравнение str_replace() и str_ireplace():

<?php

$string = "Привет, Мир!";

echo str_replace("мир", "PHP", $string) . "n"; // Выведет: Привет, Мир!

echo str_ireplace("мир", "PHP", $string) . "n"; // Выведет: Привет, PHP!

?>

str_ireplace() игнорирует регистр символов.


Важно:

* str_replace() чувствительна к регистру. Если нужно игнорировать регистр, используйте str_ireplace().
* Обращайте внимание на длину массивов $search и $replace при работе с массивами.
* Для сложных шаблонов поиска и замены лучше использовать регулярные выражения с функцией preg_replace(). str_replace() может быть неэффективной для большого количества замен в длинных строках.
* При работе с большим количеством данных, strtr() может быть более эффективной альтернативой для множественных замен.

P. S статью подготовил СМЕХ