PHP str_replace(): Mengganti Teks di Dalam String

str_replace($search, $replace, $subject) mengembalikan salinan $subject yang setiap kemunculan $search-nya sudah diganti dengan $replace. str_replace('world', 'PHP', 'Hello world') mengembalikan "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

Fungsi ini mengembalikan string baru; variabel yang kamu berikan tidak diubah. Simpan hasilnya, bahkan ke variabel yang sama: $text = str_replace(...).

Sintaks

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

Masing-masing dari tiga argumen pertama bisa berupa string atau array. Kalau $subject berupa array, penggantian dijalankan pada setiap elemen dan kamu mendapat array kembali dengan key yang sama: str_replace('.txt', '.md', ['a.txt', 'b.txt']) mengembalikan ['a.md', 'b.md']. Pencariannya peka huruf besar kecil dan mencocokkan teks biasa, bukan pola. Untuk pola, pakai preg_replace().

Mengganti beberapa string sekaligus

Berikan array untuk $search dan $replace. Nilai pencarian pertama diganti dengan pengganti pertama, yang kedua dengan pengganti kedua, dan seterusnya. Kalau $replace berupa satu string, setiap nilai pencarian diganti dengan string itu, dan inilah cara singkat untuk menghapus sekumpulan karakter.

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

Jebakan urutan dan strtr()

Dengan array, str_replace() menjalankan penggantian satu per satu pada seluruh string. Pencarian berikutnya bisa cocok dengan teks yang baru saja disisipkan oleh penggantian sebelumnya. strtr() dengan array mengganti semuanya dalam satu kali jalan, mencoba key terpanjang lebih dulu, dan tidak pernah menyentuh teks yang sudah diganti.

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

Pakai strtr() untuk menukar kata dan untuk placeholder template yang mungkin muncul di dalam nilainya.

Menghitung jumlah penggantian

Argumen keempat diisi dengan jumlah penggantian yang dilakukan. Berikan sebuah variabel; PHP akan menulis ke dalamnya.

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

Mengganti tanpa peka huruf besar kecil dengan str_ireplace

str_ireplace() menerima argumen yang sama dan mengabaikan huruf besar kecil saat mencocokkan. Penggantinya disisipkan persis seperti yang kamu tulis.

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

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

str_ireplace() hanya menyamakan huruf ASCII. Untuk penggantian yang tidak peka huruf besar kecil pada huruf beraksen atau huruf Sirilik, pakai preg_replace() dengan modifier i dan u.

Mengganti kemunculan pertama saja

str_replace() selalu mengganti semuanya. Untuk mengganti kecocokan pertama saja, cari dengan strpos() lalu potong dengan 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";

Untuk kemunculan terakhir, pakai strrpos() sebagai ganti strpos().

Menghapus spasi, baris baru, dan karakter lain

Mengganti dengan string kosong berarti menghapus teksnya. Pembersihan yang umum adalah menghapus pergantian baris atau semua spasi, dan input berbahasa Jepang sering berisi spasi lebar penuh (　, U+3000) yang tidak cocok dengan pencarian " " biasa.

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

Taruh "\r\n" sebelum "\n" dan "\r" di dalam array, supaya pergantian baris Windows menjadi satu spasi, bukan dua.