Fungsi str_replace() Pada PHP

76 views | by Admin

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.

Catatan: Jika Anda membutuhkan pencarian dan penggantian yang tidak mempertimbangkan huruf besar/kecil, gunakan 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, pakailah str_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.