str_replace() w PHP: zamiana tekstu w stringu

str_replace($search, $replace, $subject) zwraca kopię $subject, w której każde wystąpienie $search jest zastąpione przez $replace. str_replace('world', 'PHP', 'Hello world') zwraca "Hello PHP".

<?php
$text = 'I like cats. cats are great.';

$new = str_replace('cats', 'dogs', $text);

echo $new, "\n";
echo $text, "\n";   // the original is unchanged

Funkcja zwraca nowy string; nie modyfikuje przekazanej zmiennej. Przypisz wynik, nawet do tej samej zmiennej: $text = str_replace(...).

Składnia

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

Każdy z pierwszych trzech argumentów może być stringiem albo tablicą. Jeśli $subject jest tablicą, zamiana działa na każdym elemencie i dostajesz z powrotem tablicę z tymi samymi kluczami: str_replace('.txt', '.md', ['a.txt', 'b.txt']) zwraca ['a.md', 'b.md']. Wyszukiwanie rozróżnia wielkość liter i dopasowuje zwykły tekst, a nie wzorce. Do wzorców użyj preg_replace().

Zamiana kilku stringów naraz

Przekaż tablice jako $search i $replace. Pierwsza szukana wartość jest zastępowana pierwszym zamiennikiem, druga drugim i tak dalej. Jeśli $replace jest pojedynczym stringiem, zastępuje każdą szukaną wartość, co jest krótkim sposobem na usunięcie zestawu znaków.

<?php
$template = 'Hello {name}, your order {id} has shipped.';

echo str_replace(['{name}', '{id}'], ['Ada', '#1042'], $template), "\n";

// One replacement for every search value: remove punctuation
echo str_replace(['.', ',', '!', '?'], '', 'Hi, there! Ready? Yes.'), "\n";

// Fewer replacements than searches: the missing ones are ""
echo str_replace(['a', 'b', 'c'], ['1'], 'abcabc'), "\n";

Pułapka kolejności i strtr()

Przy tablicach str_replace() wykonuje jedną zamianę po drugiej na całym stringu. Późniejsze wyszukiwanie może trafić w tekst, który właśnie wstawiła wcześniejsza zamiana. strtr() z tablicą zamienia wszystko w jednym przebiegu, najpierw próbuje najdłuższych kluczy i nigdy nie rusza tekstu, który już zamienił.

<?php
$s = 'apple banana';

// apple -> banana, then every banana (including the new one) -> cherry
echo str_replace(['apple', 'banana'], ['banana', 'cherry'], $s), "\n";

// One pass: each original word is replaced once
echo strtr($s, ['apple' => 'banana', 'banana' => 'cherry']), "\n";

Używaj strtr() do zamian miejscami i do znaczników w szablonach, które mogą pojawić się w wartościach.

Liczenie zamian

Czwarty argument zostaje wypełniony liczbą wykonanych zamian. Przekaż zmienną; PHP zapisze do niej wynik.

<?php
$text = 'one fish, two fish, red fish, blue fish';

$result = str_replace('fish', 'cat', $text, $count);

echo $result, "\n";
echo "Replaced $count times\n";

Zamiana bez rozróżniania wielkości liter przez str_ireplace

str_ireplace() przyjmuje te same argumenty i przy dopasowaniu ignoruje wielkość liter. Zamiennik jest wstawiany dokładnie tak, jak go zapisałeś.

<?php
$text = 'PHP, php and Php';

echo str_replace('php', 'Python', $text), "\n";
echo str_ireplace('php', 'Python', $text), "\n";

str_ireplace() uwzględnia tylko litery ASCII. Do zamiany bez rozróżniania wielkości liter dla liter z akcentami, polskich czy cyrylicy użyj preg_replace() z modyfikatorami i i u.

Zamiana tylko pierwszego wystąpienia

str_replace() zawsze zamienia wszystko. Aby zamienić tylko pierwsze dopasowanie, znajdź je przez strpos() i wytnij przez substr_replace():

<?php
function replaceFirst(string $search, string $replace, string $subject): string
{
    $pos = strpos($subject, $search);
    if ($pos === false) {
        return $subject;
    }
    return substr_replace($subject, $replace, $pos, strlen($search));
}

echo replaceFirst('a', 'A', 'banana'), "\n";

// The same with a regex and a limit of 1
echo preg_replace('/' . preg_quote('a', '/') . '/', 'A', 'banana', 1), "\n";

Dla ostatniego wystąpienia użyj strrpos() zamiast strpos().

Usuwanie spacji, znaków nowej linii i innych znaków

Zamiana na pusty string usuwa tekst. Częste porządki to usunięcie znaków końca linii albo wszystkich spacji, a japońskie dane często zawierają spacje pełnej szerokości (　, U+3000), których zwykłe wyszukiwanie " " nie dopasuje.

<?php
$text = "line one\r\nline two\nline three";
echo str_replace(["\r\n", "\n", "\r"], ' ', $text), "\n";

$phone = '090 1234 5678';
echo str_replace(' ', '', $phone), "\n";

$name = '山田　太郎';
echo str_replace('　', ' ', $name), "\n";   // full-width space to normal space

Umieść "\r\n" w tablicy przed "\n" i "\r", aby koniec linii z Windows stał się jedną spacją, a nie dwiema.