PHP str_replace(): sostituire testo in una stringa

str_replace($search, $replace, $subject) restituisce una copia di $subject con ogni occorrenza di $search sostituita da $replace. str_replace('world', 'PHP', 'Hello world') restituisce "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 funzione restituisce la nuova stringa; non modifica la variabile che passi. Assegna il risultato, anche alla stessa variabile: $text = str_replace(...).

Sintassi

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

Ciascuno dei primi tre argomenti può essere una stringa o un array. Se $subject è un array, la sostituzione viene eseguita su ogni elemento e ottieni un array con le stesse chiavi: str_replace('.txt', '.md', ['a.txt', 'b.txt']) restituisce ['a.md', 'b.md']. La ricerca distingue maiuscole e minuscole e confronta testo semplice, non schemi. Per gli schemi usa preg_replace().

Sostituire più stringhe insieme

Passa degli array per $search e $replace. Il primo valore cercato viene sostituito dalla prima sostituzione, il secondo dalla seconda, e così via. Se $replace è una sola stringa, ogni valore cercato viene sostituito da essa, che è il modo breve per rimuovere un insieme di caratteri.

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

La trappola dell'ordine e strtr()

Con gli array, str_replace() esegue una sostituzione dopo l'altra sull'intera stringa. Una ricerca successiva può trovare testo appena inserito da una sostituzione precedente. strtr() con un array sostituisce tutto in un solo passaggio, prova prima le chiavi più lunghe e non tocca mai il testo già sostituito.

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

Usa strtr() per gli scambi e per i segnaposto dei template che potrebbero comparire nei valori.

Contare le sostituzioni

Il quarto argomento viene riempito con il numero di sostituzioni effettuate. Passa una variabile; PHP ci scrive dentro.

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

Sostituzione senza distinzione tra maiuscole e minuscole con str_ireplace

str_ireplace() accetta gli stessi argomenti e ignora maiuscole e minuscole nella ricerca. La sostituzione viene inserita esattamente come l'hai scritta.

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

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

str_ireplace() uniforma solo le lettere ASCII. Per una sostituzione che ignori le maiuscole di lettere accentate o cirilliche, usa preg_replace() con i modificatori i e u.

Sostituire solo la prima occorrenza

str_replace() sostituisce sempre tutto. Per sostituire solo la prima corrispondenza, trovala con strpos() e tagliala con 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";

Per l'ultima occorrenza, usa strrpos() al posto di strpos().

Rimuovere spazi, a capo e altri caratteri

Sostituire con una stringa vuota rimuove il testo. Una pulizia comune rimuove le interruzioni di riga o tutti gli spazi, e l'input giapponese contiene spesso spazi a larghezza piena (　, U+3000) che una normale ricerca di " " non trova.

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

Metti "\r\n" prima di "\n" e "\r" nell'array, così un a capo di Windows diventa uno spazio e non due.