Fungsi WP_DEBUG_LOG: Panduan Teknis Pelacakan Error WordPress

Apa Itu WP_DEBUG_LOG?

WP_DEBUG_LOG adalah konstanta PHP dalam WordPress yang berfungsi untuk mencatat (log) semua pesan error, peringatan (warnings), dan pemberitahuan (notices) ke dalam sebuah file teks bernama debug.log. Secara default, file ini tersimpan di direktori /wp-content/. Fungsi utama dari fitur ini adalah memungkinkan pengembang atau pemilik situs untuk meninjau masalah teknis di balik layar tanpa harus menampilkan pesan error tersebut secara langsung kepada pengunjung situs.

Cara Mengaktifkan WP_DEBUG_LOG

Untuk mengaktifkan fitur ini, Anda perlu menyunting file wp-config.php yang terletak di direktori utama instalasi WordPress Anda. Pastikan Anda memiliki akses ke file tersebut melalui FTP atau File Manager di panel hosting.

Langkah-langkah Teknis:

  1. Akses file wp-config.php melalui FTP atau File Manager.
  2. Cari baris kode define('WP_DEBUG', false);.
  3. Ubah atau tambahkan baris kode berikut di bawahnya:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Penjelasan Kode:

KonstantaFungsi
WP_DEBUGMengaktifkan mode debugging secara umum.
WP_DEBUG_LOGMenyimpan pesan error ke file /wp-content/debug.log.
WP_DEBUG_DISPLAYMenyembunyikan pesan error agar tidak muncul di layar pengunjung (disarankan false untuk situs live).

Mengapa Menggunakan WP_DEBUG_LOG?

Menggunakan WP_DEBUG_LOG jauh lebih aman dibandingkan membiarkan pesan error muncul di layar (WP_DEBUG_DISPLAY). Berikut adalah keunggulan utamanya:

  • Keamanan: Mencegah informasi sensitif seperti path server atau struktur database terlihat oleh publik.
  • Kemudahan Analisis: Anda dapat meninjau riwayat error kapan saja tanpa harus menunggu error tersebut muncul kembali secara real-time.
  • Stabilitas: Membantu mengidentifikasi konflik antara tema, plugin, atau perubahan kode kustom dengan lebih presisi.

Troubleshooting dan Tips Lapangan

Jika file debug.log tidak muncul setelah Anda mengaktifkan konfigurasi di atas, periksa hal berikut:

  • Izin File (Permissions): Pastikan direktori /wp-content/ memiliki izin tulis (write permission) agar WordPress dapat membuat file baru.
  • Lokasi File: Jika Anda tidak menemukannya di /wp-content/, periksa apakah ada konfigurasi kustom yang mengarahkan log ke lokasi lain melalui WP_DEBUG_LOG_PATH.
  • Pembersihan: File log dapat membengkak seiring waktu. Pastikan untuk menghapus atau mengosongkan isi file debug.log secara berkala setelah masalah terselesaikan untuk menghemat ruang penyimpanan server.