PHP str_replace(): Text in einem String ersetzen

str_replace($search, $replace, $subject) liefert eine Kopie von $subject, in der jedes Vorkommen von $search durch $replace ersetzt ist. str_replace('world', 'PHP', 'Hello world') liefert "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

Die Funktion liefert den neuen String; sie ändert die übergebene Variable nicht. Weise das Ergebnis zu, auch an dieselbe Variable: $text = str_replace(...).

Syntax

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

Jedes der ersten drei Argumente kann ein String oder ein Array sein. Ist $subject ein Array, läuft die Ersetzung über jedes Element, und du bekommst ein Array mit denselben Schlüsseln zurück: str_replace('.txt', '.md', ['a.txt', 'b.txt']) liefert ['a.md', 'b.md']. Die Suche unterscheidet Groß- und Kleinschreibung und trifft reinen Text, keine Muster. Für Muster verwendest du preg_replace().

Mehrere Strings auf einmal ersetzen

Übergib Arrays für $search und $replace. Der erste Suchwert wird durch den ersten Ersatz ersetzt, der zweite durch den zweiten und so weiter. Ist $replace ein einzelner String, wird jeder Suchwert dadurch ersetzt, der kurze Weg, eine Reihe von Zeichen zu entfernen.

<?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";

Die Reihenfolge-Falle und strtr()

Mit Arrays führt str_replace() eine Ersetzung nach der anderen über den ganzen String aus. Eine spätere Suche kann Text treffen, den eine frühere Ersetzung gerade eingefügt hat. strtr() mit einem Array ersetzt alles in einem einzigen Durchgang, probiert die längsten Schlüssel zuerst und rührt bereits ersetzten Text nie wieder an.

<?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";

Verwende strtr() für Vertauschungen und für Template-Platzhalter, die in den Werten vorkommen könnten.

Die Ersetzungen zählen

Das vierte Argument wird mit der Anzahl der vorgenommenen Ersetzungen gefüllt. Übergib eine Variable; PHP schreibt hinein.

<?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";

Ersetzen ohne Groß- und Kleinschreibung mit str_ireplace

str_ireplace() nimmt dieselben Argumente und ignoriert beim Vergleich Groß- und Kleinschreibung. Der Ersatz wird genau so eingefügt, wie du ihn geschrieben hast.

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

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

str_ireplace() behandelt nur ASCII-Buchstaben ohne Groß- und Kleinschreibung. Um Umlaute, Akzente oder kyrillische Buchstaben so zu ersetzen, verwendest du preg_replace() mit den Modifikatoren i und u.

Nur das erste Vorkommen ersetzen

str_replace() ersetzt immer alles. Um nur den ersten Treffer zu ersetzen, suchst du ihn mit strpos() und schneidest ihn mit substr_replace() heraus:

<?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";

Für das letzte Vorkommen verwendest du strrpos() statt strpos().

Leerzeichen, Zeilenumbrüche und andere Zeichen entfernen

Mit einem leeren String zu ersetzen, entfernt den Text. Eine häufige Bereinigung entfernt Zeilenumbrüche oder alle Leerzeichen, und japanische Eingaben enthalten oft vollbreite Leerzeichen (　, U+3000), die eine normale Suche nach " " nicht trifft.

<?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

Setze "\r\n" im Array vor "\n" und "\r", damit ein Windows-Zeilenumbruch zu einem Leerzeichen wird und nicht zu zweien.