Cara Mengaktifkan Mode Debug di WordPress
Mengaktifkan mode debug memerlukan pengeditan satu file di instalasi WordPress Anda. Proses ini sederhana, tetapi harus dilakukan dengan hati-hati agar tidak merusak situs. Di bawah ini Anda akan menemukan panduan langkah demi langkah untuk melakukannya dengan benar.
Setelah diaktifkan, Anda dapat mencatat kesalahan, menyembunyikannya dari pengunjung, dan mengontrol bagaimana WordPress menangani informasi debug. Ini sangat penting pada situs produksi, di mana kesalahan perlu dicatat tetapi tidak ditampilkan secara publik.
Menemukan File wp-config.php
Langkah pertama untuk mengaktifkan mode debug adalah menemukan file wp-config.php. File ini terletak di folder root instalasi WordPress Anda, di tempat yang sama dengan wp-content, wp-includes, dan wp-admin. Anda dapat mengaksesnya melalui perangkat lunak FTP, pengelola file pada panel hosting Anda, atau akses lokal jika Anda bekerja di server pengembangan.
Disarankan untuk membuat salinan cadangan file ini sebelum melakukan perubahan. Satu karakter yang hilang dapat merusak situs Anda, dan cadangan memastikan Anda dapat memulihkannya segera. Setelah menemukan file, buka dengan editor teks dan siapkan untuk mengubah konfigurasinya.
Mengaktifkan WP_DEBUG
Di dalam file wp-config.php, gulir hingga menemukan baris seperti ini: define( 'WP_DEBUG', false );. Baris ini mengontrol apakah mode debug aktif atau tidak. Secara default, WordPress menonaktifkan debugging demi alasan keamanan dan kinerja. Untuk mengaktifkannya, cukup ubah nilai dari false menjadi true.
Baris yang benar seharusnya terlihat seperti ini: define( 'WP_DEBUG', true );. Setelah menyimpan file, WordPress segera mulai menampilkan peringatan, pemberitahuan, dan pesan kesalahan PHP di seluruh situs Anda. Hal ini memungkinkan Anda mengidentifikasi plugin, tema, atau kode kustom yang bermasalah.
Menggunakan WP_DEBUG_LOG untuk Pencatatan Kesalahan
Menampilkan kesalahan di layar bisa berguna selama pengembangan, tetapi tidak selalu praktis. Untuk pemantauan jangka panjang, Anda dapat mengaktifkan WP_DEBUG_LOG. Untuk melakukannya, tambahkan baris berikut tepat di bawah konstanta WP_DEBUG: define( 'WP_DEBUG_LOG', true );. Ini akan menyimpan semua kesalahan ke file debug.log di dalam direktori wp-content.
Memiliki file log sangat membantu ketika Anda perlu melacak kesalahan yang terjadi pada waktu tertentu, atau ketika Anda tidak dapat mereproduksinya langsung di layar. Ini juga memungkinkan Anda berbagi file dengan pengembang atau tim dukungan tanpa memberi mereka akses langsung ke situs.
Menyembunyikan Kesalahan dari Pengunjung
Jika situs WordPress Anda sudah live, Anda mungkin tidak ingin pengunjung melihat pesan kesalahan mentah. Dalam kasus ini, Anda dapat menambahkan pengaturan lain untuk menonaktifkan tampilan frontend: define( 'WP_DEBUG_DISPLAY', false );. Dengan cara ini, kesalahan tetap dicatat tetapi tidak ditampilkan kepada pengguna.
Selain itu, Anda dapat menambahkan @ini_set( 'display_errors', 0 ); untuk memperkuat perilaku ini. Kombinasi ini membuat situs Anda tetap terlihat profesional dan aman, sambil tetap menyediakan informasi yang diperlukan di log debug untuk administrator dan pengembang.
Debugging Lanjutan dengan SCRIPT_DEBUG
Bagi pengembang yang bekerja dengan JavaScript dan CSS, WordPress menawarkan konstanta tambahan: define( 'SCRIPT_DEBUG', true );. Secara default, WordPress memuat versi skrip dan style yang sudah diminifikasi. Mengaktifkan script debugging memaksa WordPress memuat versi lengkap yang tidak diminifikasi, sehingga lebih mudah diperiksa dan diuji.
Pengaturan ini sangat berguna jika Anda mengembangkan tema atau plugin dan perlu menelusuri bagaimana skrip dan style bekerja. Biasanya tidak diperlukan oleh pengguna umum, tetapi bisa sangat membantu pengembang yang menyelesaikan masalah frontend.
Singkatnya, mengaktifkan mode debug di WordPress adalah cara sederhana namun kuat untuk mendiagnosis dan memelihara situs web Anda. Dengan mengedit file wp-config.php, Anda dapat menampilkan kesalahan, menyimpannya dalam log, dan tetap menjaga tampilan profesional situs bahkan saat masalah muncul. Jika digunakan dengan benar, mode debug adalah salah satu alat terpenting untuk menjaga WordPress tetap aman, stabil, dan ramah bagi pengembang.
