Error layar putih pada web hosting, yang secara universal dikenal sebagai White Screen of Death (WSOD), terjadi ketika halaman website hanya menampilkan layar kosong tanpa pesan error yang spesifik. Akar permasalahan ini umumnya bersumber dari skrip PHP yang mengalami kegagalan fatal (fatal error), kehabisan batas memori (memory limit), atau konflik pada plugin dan tema yang terpasang di server.
Untuk mengatasi masalah ini secara cepat dan tepat, Anda memerlukan akses ke panel kontrol hosting (seperti cPanel atau hPanel) serta akses file melalui File Manager atau FTP. Berikut adalah tabel matriks diagnostik untuk mengidentifikasi penyebab utama berdasarkan gejala yang menyertai layar putih:
| Penyebab Utama | Gejala Lapangan | Langkah Penanganan Cepat |
|---|---|---|
| Memory Limit Tercapai | Terjadi setelah menginstal plugin baru atau mengakses halaman admin yang berat. | Meningkatkan nilai memory_limit melalui arquivo wp-config.php atau php.ini. |
| Konflik Plugin / Tema | Layar putih muncul sesaat setelah memperbarui plugin, tema, atau inti CMS. | Melakukan rename folder plugin atau tema via File Manager. |
| Versi PHP Tidak Kompatibel | Terjadi usai melakukan upgrade versi PHP di panel hosting tanpa pengecekan kodenya. | Menurunkan versi PHP atau memperbaiki kode fungsi yang deprecated. |
| Cache Rusak | Website bisa diakses via mode incognito tetapi error di browser utama. | Menghapus direktori cache pada folder plugin cache atau server level cache. |
Langkah Teknis Penanganan Error Layar Putih
1. Mengaktifkan Debugging PHP
Karena layar putih menyembunyikan pesan error demi keamanan, Anda harus mengaktifkannya secara manual untuk melihat baris kode mana yang bermasalah. Buka file wp-config.php (jika menggunakan WordPress) di root direktori website Anda, lalu cari baris kode berikut:
define( 'WP_DEBUG', false );
Ubah kode tersebut menjadi konfigurasi debug aktif:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', true );
Simpan file tersebut dan muat ulang (refresh) halaman website Anda. Pesan error spesifik beserta nama file dan nomor baris yang rusak akan langsung muncul di layar.
2. Meningkatkan PHP Memory Limit
Batasan memori bawaan server sering kali tidak mencukupi untuk memproses skrip yang kompleks. Anda dapat menambah alokasi memori dengan menyisipkan baris kode ini di dalam file wp-config.php sebelum kalimat "That's all, stop editing!":
define( 'WP_MEMORY_LIMIT', '256M' );
Jika menggunakan CMS selain WordPress, sesuaikan nilai memori pada file konfigurasi utama atau ubah melalui menu Select PHP Version > Options di cPanel hosting Anda.
3. Menonaktifkan Seluruh Plugin Secara Massal
Jika Anda tidak dapat mengakses dashboard admin, penonaktifan plugin harus dilakukan melalui direktori server:
- Masuk ke cPanel dan buka File Manager.
- Navigasi ke direktori instalasi website Anda (contoh:
public_html/wp-content/). - Cari folder bernama
plugins. - Ubah nama (rename) folder tersebut menjadi
plugins_old. - Periksa website Anda. Jika kembali normal, berarti salah satu plugin mengalami konflik. Kembalikan nama folder menjadi
plugins, lalu ubah nama folder plugin satu per satu di dalamnya untuk menemukan plugin yang rusak.
4. Mengganti Tema ke Tema Default
Metode yang sama berlaku untuk tema website. Jika tema yang Anda gunakan mengalami korupsi data atau ketidakcocokan versi PHP, website akan menampilkan layar putih:
- Masuk ke direktori
public_html/wp-content/themes/melalui File Manager. - Rename folder tema aktif Anda (misalnya tema
astramenjadiastra_old). - Sistem secara otomatis akan mengaktifkan tema default bawaan (seperti Twenty Twenty-Three).
- Periksa kembali halaman website di browser.
Tips Mencegah WSOD di Masa Mendatang
Selalu lakukan pencadangan (backup) penuh database dan file website sebelum melakukan pembaruan tema, plugin, maupun versi PHP hosting. Pastikan pula Anda selalu menggunakan versi PHP yang didukung oleh pengembang skrip atau CMS yang Anda gunakan untuk meminimalisir risiko kegagalan fungsi eksekusi kode.