PHP str_replace() : remplacer du texte dans une chaîne

str_replace($search, $replace, $subject) renvoie une copie de $subject où chaque occurrence de $search est remplacée par $replace. str_replace('world', 'PHP', 'Hello world') renvoie "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

La fonction renvoie la nouvelle chaîne ; elle ne modifie pas la variable que vous passez. Affectez le résultat, même à la même variable : $text = str_replace(...).

Syntaxe

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

Chacun des trois premiers arguments peut être une chaîne ou un tableau. Si $subject est un tableau, le remplacement s'applique à chaque élément et vous obtenez un tableau avec les mêmes clés : str_replace('.txt', '.md', ['a.txt', 'b.txt']) renvoie ['a.md', 'b.md']. La recherche est sensible à la casse et compare du texte brut, pas des motifs. Pour des motifs, utilisez preg_replace().

Remplacer plusieurs chaînes à la fois

Passez des tableaux pour $search et $replace. La première valeur cherchée est remplacée par le premier remplacement, la deuxième par le deuxième, et ainsi de suite. Si $replace est une seule chaîne, chaque valeur cherchée est remplacée par elle, ce qui est le moyen court de supprimer un ensemble de caractères.

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

Le piège de l'ordre et strtr()

Avec des tableaux, str_replace() applique les remplacements l'un après l'autre sur toute la chaîne. Une recherche ultérieure peut trouver du texte qu'un remplacement précédent vient d'insérer. strtr() avec un tableau remplace tout en une seule passe, essaie d'abord les clés les plus longues et ne touche jamais au texte déjà remplacé.

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

Utilisez strtr() pour des échanges et pour des marqueurs de template qui pourraient apparaître dans les valeurs.

Compter les remplacements

Le quatrième argument reçoit le nombre de remplacements effectués. Passez une variable ; PHP écrit dedans.

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

Remplacement insensible à la casse avec str_ireplace

str_ireplace() prend les mêmes arguments et ignore la casse lors de la recherche. Le remplacement est inséré exactement comme vous l'avez écrit.

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

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

str_ireplace() ne gère la casse que pour les lettres ASCII. Pour un remplacement insensible à la casse de lettres accentuées ou cyrilliques, utilisez preg_replace() avec les modificateurs i et u.

Remplacer seulement la première occurrence

str_replace() remplace toujours tout. Pour ne remplacer que la première correspondance, trouvez-la avec strpos() et découpez-la avec 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";

Pour la dernière occurrence, utilisez strrpos() à la place de strpos().

Supprimer espaces, sauts de ligne et autres caractères

Remplacer par une chaîne vide supprime le texte. Un nettoyage courant supprime les sauts de ligne ou tous les espaces, et une saisie japonaise contient souvent des espaces pleine chasse (　, U+3000) qu'une recherche de " " normale ne trouve pas.

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

Placez "\r\n" avant "\n" et "\r" dans le tableau, pour qu'un saut de ligne Windows devienne un seul espace et non deux.