Cara Mengatasi WordPress White Screen Setelah Edit wp-config.php

The Last Digital
... minutes read

Mengapa Edit wp-config.php Bisa Menghasilkan Layar Putih?

Anda mengedit wp-config.php — mungkin untuk menaikkan memori, mengaktifkan debug, atau mengubah kredensial database — lalu situs hanya menampilkan halaman putih kosong. Tidak ada pesan error, tidak ada dasbor, tidak ada yang bisa diklik. Inilah yang disebut White Screen of Death (WSOD).

Penyebabnya bisa dipahami dengan satu fakta: wp-config.php adalah file pertama yang dieksekusi dalam setiap permintaan WordPress, sebelum WordPress core, sebelum penanganan error, dan sebelum plugin apa pun yang bisa menangkap masalah dengan anggun. Jika file ini mengandung kesalahan sintaks PHP, tidak ada yang berjalan — sama sekali. Kabar baiknya, karena file ini juga yang terakhir Anda ubah, pelakunya hampir pasti ada di sana, dan pemulihannya biasanya cepat.

Jawaban Singkat: Cara Mengatasi White Screen Setelah Edit wp-config.php

Jangan panik dan jangan mengutak-atik hal lain dulu. Dapatkan akses file lewat SFTP atau File Manager hosting, unduh wp-config.php yang sekarang, dan periksa baris yang terakhir Anda ubah: tanda kutip yang tidak tertutup, titik koma yang hilang, atau spasi/baris kosong sebelum <?php. Jika Anda tidak yakin baris mana yang salah, kembalikan salinan backup wp-config.php Anda. Jika tidak ada backup sama sekali, bangun ulang file dari wp-config-sample.php dengan kredensial database dari panel hosting Anda. Setelah situs kembali, aktifkan mode debug dengan cara yang aman (log ke file, bukan tampil di layar) untuk memastikan tidak ada error yang tersisa.

Persiapan: Yang Anda Butuhkan

  • Akses file, bukan dasbor. Dasbor tidak bisa diakses karena WordPress tidak termuat. Anda membutuhkan SFTP/FTP atau File Manager hosting.
  • Editor kode yang tepat. Pakai VS Code, Notepad++, atau Sublime Text — bukan Notepad Windows atau TextEdit yang bisa menyisipkan karakter tersembunyi.
  • Backup sebelum perbaikan. Unduh dulu wp-config.php yang rusak itu sebagai wp-config.php.rusak sebelum mengubahnya. Salinan ini berguna untuk membandingkan dan untuk melihat persis apa yang berubah.

Langkah 1: Baca Pesan Error yang Sebenarnya

Layar putih kosong bukan berarti tidak ada pesan error — hanya saja tampilannya dimatikan. Ada dua cara untuk melihatnya:

Periksa log error PHP di server

tail -20 /var/log/php-fpm/error.log
tail -20 /var/log/apache2/error.log
tail -20 /var/log/nginx/error.log
php -i | grep error_log

Pesan seperti PHP Parse error: syntax error, unexpected end of file in /var/www/html/wp-config.php on line 47 memberi tahu Anda persis baris yang bermasalah. Itu adalah petunjuk terbaik yang bisa Anda dapatkan — ikuti nomor barisnya.

Aktifkan debug log WordPress (cara aman)

Jika log server tidak tersedia, tambahkan tiga baris berikut di wp-config.php — di atas baris /* That's all, stop editing! */ — tetapi ingat: file yang rusak karena sintaks tidak akan bisa memuat baris ini sampai sintaksnya diperbaiki dulu. Jadi cara ini berguna setelah perbaikan awal, atau bila layar putih disebabkan hal lain (plugin, tema, memori):

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

Setelah itu, muat ulang situs dan baca wp-content/debug.log. Kombinasi ini mencatat error ke file tanpa menampilkannya ke pengunjung — penting, karena pesan error bisa membocorkan jalur file dan struktur server Anda. Setelah selesai, kembalikan WP_DEBUG ke false.

Langkah 2: Perbaiki Kesalahan Sintaks Paling Umum

Buka wp-config.php di editor kode dan periksa perubahan terakhir Anda terhadap daftar ini:

KesalahanContoh SalahPerbaikan
Titik koma hilangdefine( 'WP_MEMORY_LIMIT', '256M' )Tambahkan ; di akhir baris
Tanda kutip tidak tertutupdefine( 'DB_NAME', 'wordpress );Tutup kutipnya: 'wordpress'
Spasi/baris kosong sebelum <?phpBaris kosong di baris pertama fileHapus semua karakter sebelum <?php
Karakter tak terlihat dari copy-pasteKutipan melengkung (') dari editor dokumenGanti dengan kutip lurus (') dan ketik ulang barisnya
Konstanta ditulis di bawah baris "stop editing"define() setelah require_once wp-settings.phpPindahkan ke atas baris /* That's all, stop editing! */

Dua poin terakhir sering terlewat. Pertama, spasi atau baris kosong sebelum <?php (atau setelah penutup ?> bila ada) dapat memicu masalah header dan layar putih. Kedua, konstanta yang ditulis di bawah baris "stop editing" — apalagi di bawah require_once ABSPATH . 'wp-settings.php' — secara teknis ada, tetapi WordPress sudah membuat keputusannya tanpa konstanta itu, sehingga pengaturannya tidak berpengaruh.

Tips praktis: jalankan pemeriksaan sintaks PHP sebelum menyimpan perubahan berikutnya:

php -l wp-config.php

Jika keluarannya No syntax errors detected, sintaksnya aman — setidaknya dari sisi parser PHP.

Langkah 3: Kembalikan dari Backup (Jika Sintaks Sulit Ditemukan)

Jika Anda tidak yakin baris mana yang salah atau file sudah terlanjur berantakan, mengembalikan backup lebih cepat daripada menebak-nebak:

cp wp-config.php.bak wp-config.php
# atau, jika memakai version control:
git checkout wp-config.php

Beberapa plugin caching atau pengelola konfigurasi juga menyimpan salinan cadangan — periksa file seperti wp-content/wp-config-backup* bila ada. Setelah mengembalikan backup, muat ulang situs: jika kembali normal, Anda sudah mengonfirmasi bahwa edit terakhirlah penyebabnya, dan Anda bisa mengulang edit itu dengan lebih hati-hati.

Langkah 4: Bangun Ulang dari wp-config-sample.php (Jika Tidak Ada Backup)

Jika tidak ada backup sama sekali, Anda masih bisa membangun ulang file dari templat bawaan WordPress:

cp wp-config-sample.php wp-config.php

Lalu isi empat nilai database dari panel hosting Anda (atau dari backup hosting):

define( 'DB_NAME', 'nama_database_anda' );
define( 'DB_USER', 'user_database_anda' );
define( 'DB_PASSWORD', 'password_database_anda' );
define( 'DB_HOST', 'localhost' );

Perhatian: DB_HOST tidak selalu localhost — sebagian host memakai alamat seperti mysql.domainanda.com. Periksa nilai yang benar di panel hosting Anda. Konten Anda aman selama proses ini karena konten tersimpan di database, bukan di file ini. Jika setelah membangun ulang Anda mendapat pesan "Error establishing a database connection", keempat nilai di ataslah yang perlu dicek ulang, satu per satu.

Langkah 5: Jika Layar Putih Bertahan Setelah wp-config.php Beres

Kadang edit wp-config.php hanya kebetulan bersamaan dengan penyebab lain. Jika sintaks sudah bersih tetapi layar putih tetap ada, lanjutkan dengan pemeriksaan berikut, satu per satu:

  1. Nonaktifkan plugin. Lewat FTP, ganti nama folder wp-content/plugins menjadi plugins_old. Jika situs kembali, aktifkan plugin satu per satu untuk menemukan pelakunya.
  2. Ganti tema. Ganti nama folder tema aktif di wp-content/themes/ — WordPress akan jatuh kembali ke tema bawaan seperti Twenty Twenty-Four jika tersedia.
  3. Naikkan memori PHP. Tambahkan di atas baris "stop editing": define( 'WP_MEMORY_LIMIT', '256M' ); — tetapi ingat, jika host menetapkan batas keras lewat PHP-FPM, WordPress tidak bisa melampauinya apa pun yang Anda tulis.
  4. Periksa izin file. Sebagai langkah terakhir, pastikan folder bernilai 755 dan file 644, dengan wp-config.php di 600, 640, atau 644. Jangan membuka izin lebih lebar dari itu tanpa alasan.

Cara Memverifikasi Hasil Perbaikan

  1. Muat ulang halaman depan dan halaman /wp-admin — keduanya harus tampil normal, bukan putih.
  2. Jalankan php -l wp-config.php dan pastikan tidak ada kesalahan sintaks.
  3. Periksa wp-content/debug.log (jika debug log aktif) dan pastikan tidak ada error fatal baru.
  4. Kembalikan WP_DEBUG ke false dan hapus file debug.log lama agar tidak menumpuk atau bisa diakses publik.
  5. Simpan salinan wp-config.php yang sudah benar sebagai backup — beri nama bertanggal, misalnya wp-config.php.backup-2026-10-29 — dan simpan di luar folder web jika memungkinkan.

Troubleshooting Lanjutan

Situs menampilkan "There has been a critical error" bukan layar putih

Itu adalah mode pemulihan fatal error WordPress 5.2+. Pesan sebenarnya tetap tercatat di debug.log atau log PHP server — baca di sana, bukan dari pesan ramah di layar. Anda bisa menonaktifkan penangan ini sementara dengan define( 'WP_DISABLE_FATAL_ERROR_HANDLER', true ); saat debugging.

Error menyebut plugin atau tema, bukan wp-config.php

Ikuti jalur file di pesan error: jalur wp-content/plugins/ berarti plugin, wp-content/themes/ berarti tema, wp-includes/ atau wp-admin/ berarti core. Nonaktifkan komponen yang disebut, lalu perbarui atau ganti komponen tersebut.

Anda tidak punya akses FTP/File Manager

Hubungi dukungan hosting Anda: mereka bisa mengembalikan wp-config.php dari backup server atau memperbaiki sintaksnya untuk Anda. Jangan mencoba "memperbaiki" lewat dasbor WordPress — dasbor tidak akan termuat selama file ini rusak.

FAQ

Apakah konten saya hilang karena layar putih ini?

Tidak. Konten, pengguna, dan pengaturan tersimpan di database. Layar putih karena wp-config.php berarti WordPress gagal start, bukan datanya hilang. Begitu file diperbaiki, situs kembali seperti semula.

Bolehkah saya mengedit wp-config.php lewat editor tema di dasbor?

Tidak disarankan. Editor bawaan dasbor tidak dirancang untuk file ini, dan jika edit Anda merusaknya, Anda langsung terkunci dari dasbor. Selalu edit lewat SFTP/File Manager dengan backup terlebih dahulu.

Mengapa debug saya tidak menampilkan apa-apa?

Periksa penempatan: konstanta WP_DEBUG harus berada di atas baris "stop editing" dan di atas require_once wp-settings.php. Jika ditulis di bawahnya, WordPress sudah termuat tanpa pengaturan itu.

Apakah menaikkan WP_MEMORY_LIMIT selalu memperbaiki layar putih?

Tidak. Itu hanya membantu bila penyebabnya kehabisan memori (pesan "Allowed memory size exhausted"). Bila penyebabnya kesalahan sintaks di wp-config.php, tidak ada nilai memori yang akan membantu.

Kesimpulan

White screen setelah mengedit wp-config.php hampir selalu berarti satu hal: file yang dimuat pertama kali itu mengandung kesalahan. Baca log error untuk menemukan barisnya, perbaiki sintaksnya, atau kembalikan backup Anda — dan jika tidak ada backup, bangun ulang dari wp-config-sample.php dengan kredensial database yang benar. Ke depan, jadikan tiga kebiasaan ini permanen: backup sebelum setiap edit, periksa sintaks dengan php -l sebelum menyimpan, dan uji edit di situs staging bila tersedia. Dengan begitu, satu titik koma yang hilang tidak akan pernah lagi membuat situs Anda gelap total.

Tags:

Related Posts

Memuat…
Cookie Consent