Cara Search Replace Domain WordPress Menggunakan WP-CLI

Jika Kamu melakukan migrasi website WordPress ke domain baru atau mengubah HTTP menjadi HTTPS secara manual, Kamu dapat menggunakan perintah WP-CLI search replace untuk memperbarui URL di database WordPress secara otomatis dan meminimalisir error yang terjadi.

Dibandingkan query SQL manual, WP-CLI lebih aman karena dapat menangani serialized data tanpa merusak struktur data WordPress.

Kapan Perlu Menggunakan WP-CLI Search Replace?

Beberapa kondisi yang biasanya membutuhkan search replace domain:

• Migrasi website ke domain baru.
• Mengubah HTTP menjadi HTTPS.
• Memindahkan website dari staging ke production.
• Mengganti subdomain menjadi domain utama.
• Memperbaiki URL yang masih mengarah ke domain lama.

Cara Melakukan Search Replace Domain Menggunakan WP-CLI

Sebelum memulai, pastikan di server atau hosting yang kamu gunakan sudah mendukung WP CLI. Jika belum, kamu bisa menginstallnya dulu: Cara Install WP-CLI.

1. Buka Folder Instalasi WordPress

Dari Terminal atau SSH, akses atau buka folder instalasi WordPress Kamu, misalnya di public_html

1cd public_html

2. Simulasi Perubahan Menggunakan Dry Run

Sebelum melakukan perubahan langsung di database dan konfigurasi, disarankan untuk menjalankan simulasi terlebih dahulu:

1wp search-replace 'domainlama.com' 'domainbaru.com' --report-changed-only --dry-run

Perintah di atas tidak akan mengubah database dan hanya menampilkan jumlah data yang akan diperbarui.

3. Jalankan Search Replace

Jika hasil simulasi sudah sesuai, jalankan perintah search replace dengan menghapus flag --dry-run

1wp search-replace 'domainlama.com' 'domainbaru.com' --report-changed-only

Tunggu prosesnya dan WP-CLI akan memperbarui seluruh data yang ditemukan pada database WordPress.

4. Mengubah HTTP Menjadi HTTPS

Jika ingin mengubah seluruh URL HTTP menjadi HTTPS, Kamu bisa menuliskan alamat lengkap websitemu, misalnya

1wp search-replace 'http://domainlama.com' 'https://domainbaru.com' --report-changed-only

Pastikan untuk menggunakan --dry-run sebelum menjalankan perintah search replace.

5. Verifikasi Hasil Search Replace

Untuk memastikan domain lama sudah tidak digunakan lagi, jalankan kembali simulasi:

1wp search-replace 'domainlama.com' 'domainbaru.com' --report-changed-only --dry-run

Jika tidak ada data yang ditemukan, biasanya akan muncul hasil 0 replacements to be made.

Kamu juga bisa memeriksa menu Settings > General di dashboard WordPress untuk memastikan URL website sudah menggunakan domain yang baru.

FAQ

Apakah WP-CLI Search Replace Aman Digunakan?

Ya. WP-CLI dapat menangani serialized data secara otomatis sehingga lebih aman dibanding melakukan replace menggunakan query SQL manual.

Apa Fungsi –dry-run?

Flag --dry-run digunakan untuk melakukan simulasi tanpa mengubah database. Sangat disarankan untuk menjalankan perintah ini sebelum melakukan search replace.

Apakah Perlu Backup Database Sebelum Search Replace?

Sangat disarankan untuk melakukan backup database sebelum menjalankan search replace, terutama pada website production.