Fungsi str_replace() Pada PHP
Fungsi str_replace()
dalam PHP digunakan untuk mengganti
teks tertentu dengan teks lain di dalam sebuah string atau di dalam
elemen-elemen suatu array. Fungsi ini sangat bermanfaat ketika kita
ingin melakukan manipulasi string, misalnya memperbaiki salah ketik,
melakukan sensor kata, atau menyesuaikan format teks.
Fungsi Utama
Tujuan utama str_replace()
adalah mencari bagian tertentu
dari sebuah string (atau kumpulan string) kemudian menggantinya dengan
teks baru. Fungsi ini case-sensitive, yang berarti huruf besar dan kecil
dianggap berbeda. Jika Anda memerlukan pencarian dan penggantian yang
tidak peka huruf besar-kecil, gunakan str_ireplace()
.
Sintaks str_replace()
str_replace(
mixed $search,
mixed $replace,
mixed $subject,
int &$count = null
): string|array
- $search: Nilai yang ingin dicari (bisa berupa string atau array).
- $replace: Nilai pengganti (bisa berupa string atau array).
- $subject: Target string atau array yang akan diproses.
- $count (opsional): Variabel yang akan menampung jumlah seluruh penggantian yang terjadi.
Fungsi ini akan mengembalikan string jika $subject adalah string, atau array jika $subject adalah array.
Contoh Penggunaan
1. Mengganti Teks Tunggal dalam Sebuah String
Contoh berikut menunjukkan bagaimana kita dapat mengganti satu kata dengan kata lain di dalam sebuah string.
2. Mengganti Beberapa Teks Sekaligus
Kita juga dapat mengganti banyak kata sekaligus dengan menggunakan array. Urutan elemen dalam array $search berkorespondensi dengan elemen dalam array $replace.
Pada contoh di atas, "apel" akan diganti menjadi "mangga", sedangkan "jeruk" akan diganti menjadi "pisang".
3. Mengganti String dalam Array
str_replace()
juga bisa menerima array
sebagai $subject, sehingga setiap elemen dari array
tersebut akan diproses dan hasilnya dikembalikan dalam bentuk array.
Halo Teman!
// [1] => Teman ini indah.
// [2] => Selamat tinggal, Teman.
// )
?>
4. Menghitung Jumlah Penggantian
Kita dapat mengetahui berapa banyak kata atau teks yang berhasil diganti dengan menggunakan parameter $count. Ini berguna ketika Anda membutuhkan informasi statistik, misalnya untuk menampilkan laporan berapa kata yang telah diubah.
5. Penggunaan Bersama str_ireplace()
(Perbandingan)
Walaupun bukan fokus utama, berguna juga untuk mengetahui versi
case-insensitive dari str_replace()
, yakni
str_ireplace()
. Contoh di bawah memperlihatkan perbedaannya.
str_ireplace()
.
Tips dan Best Practice
- Perhatikan urutan array
$search
dan$replace
: Pastikan jumlah elemen pada kedua array sama, agar penggantian berlangsung sesuai dengan pasangan yang diinginkan. - Gunakan
str_replace()
sebelum validasi besar/kecil huruf jika memang diperlukan case-sensitive. Jika tidak, pakailahstr_ireplace()
. - Manfaatkan parameter
$count
saat perlu memantau jumlah penggantian teks, misalnya untuk keperluan logging atau laporan. - Berhati-hati saat mengganti karakter khusus (misalnya tanda
baca). Terkadang, Anda mungkin memerlukan fungsi penanganan regex seperti
preg_replace()
untuk pencarian yang lebih kompleks.
Baca Juga :