💡 ULASAN & REFERENSI • DIPERBARUI: 21 October 2026 • REDAKSI AZWINN

Cara Aktifkan WP Debug di WordPress untuk Melacak Error

Cara mengaktifkan fitur WP_DEBUG di WordPress dilakukan dengan menyunting berkas wp-config.php yang terletak di direktori akar (root) instalasi WordPress menggunakan aplikasi FTP atau File Manager di cPanel. Konfigurasi ini wajib diubah dari nilai false menjadi true agar sistem menampilkan pesan kesalahan PHP, peringatan, dan pemberitahuan secara langsung di layar situs.

Fitur bawaan WordPress ini sangat krusial bagi pengembang maupun pengelola situs untuk mendiagnosis masalah seperti layar putih kematian (White Screen of Death), konflik plugin, atau galat pada tema. Tanpa mengaktifkannya, pesan galat seringkali disembunyikan demi alasan keamanan publik, yang justru menyulitkan proses identifikasi sumber masalah.

Langkah-Langkah Mengaktifkan WP Debug

Prosedur teknis untuk mengaktifkan dan mengonfigurasi parameter pelacakan galat pada platform WordPress membutuhkan akses ke server hosting Anda.

  1. Masuk ke dasbor akun hosting Anda (cPanel, DirectAdmin, atau File Manager penyedia hosting).
  2. Buka direktori tempat WordPress terpasang (biasanya pada folder public_html).
  3. Cari berkas bernama wp-config.php, klik kanan lalu pilih Edit.
  4. Gulir halaman ke bagian bawah hingga Anda menemukan baris kode berikut:
    define( 'WP_DEBUG', false );
  5. Ubah nilai false menjadi true.
  6. Simpan perubahan berkas (Save Changes).

Tabel Parameter Konfigurasi WP Debug

Selain parameter utama, terdapat beberapa konstanta tambahan yang dapat ditambahkan ke dalam berkas wp-config.php untuk mengatur perilaku pencatatan galat sesuai kebutuhan analisis Anda.

Konstanta PHP Nilai Default Fungsi Utama
WP_DEBUG false Mengaktifkan mode penelusuran galat secara keseluruhan di WordPress.
WP_DEBUG_DISPLAY true (jika DEBUG aktif) Menampilkan pesan galat secara langsung di halaman situs web.
WP_DEBUG_LOG false Menyimpan seluruh laporan galat ke dalam berkas debug.log di folder /wp-content/.
SCRIPT_DEBUG false Memaksa WordPress menggunakan versi skrip inti yang belum diminifikasi (minified) untuk JavaScript dan CSS.
SAVEQUERIES false Menyimpan kueri database ke dalam sebuah array untuk keperluan analisis performa.

Contoh Kode Konfigurasi Lengkap

Untuk kebutuhan analisis tingkat lanjut, Anda disarankan untuk mencatat log galat ke dalam sebuah berkas khusus agar tidak mengganggu kenyamanan pengunjung situs yang sedang aktif. Berikut adalah contoh kode konfigurasi yang disarankan untuk ditempatkan sebelum baris /* That's all, stop editing! Happy publishing. */:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'WP_DEBUG_LOG', true );

Dengan konfigurasi di atas, seluruh pesan galat tidak akan muncul di layar pengunjung (karena WP_DEBUG_DISPLAY bernilai false), melainkan dicatat secara rapi ke dalam berkas debug.log di dalam direktori wp-content. Berkas log ini dapat Anda unduh dan periksa menggunakan aplikasi pembaca teks standar.

Penyelesaian Masalah (Troubleshooting) Lapangan

Setelah proses analisis dan perbaikan galat selesai dilakukan, Anda wajib mengembalikan nilai WP_DEBUG menjadi false. Membiarkan mode debug aktif pada situs yang dapat diakses publik berisiko membocorkan informasi sensitif server, struktur direktori, dan path database kepada pihak yang tidak bertanggung jawab.

Jika setelah mengubah nilai menjadi true situs Anda justru mengalami galat fatal tambahan, pastikan tidak ada kesalahan pengetikan sintaks (seperti kurangnya tanda titik koma ; atau tanda kutip tunggal) di dalam berkas wp-config.php.

🔍 Orang Lain Juga Mencari Ini