Cara Mengatasi Fatal Error Setelah Instal Plugin

Cara Mengatasi Fatal Error Setelah Instal Plugin perlu ditangani berdasarkan pesan error, log, dan perubahan terakhir pada website. Jangan langsung menghapus plugin, database, atau file tanpa backup karena tindakan acak dapat menghilangkan bukti penyebab dan memperbesar kerusakan.

Apa Arti Error Ini?

Plugin baru memicu PHP fatal error segera setelah diaktifkan.

Catat apakah masalah terjadi pada semua halaman, hanya wp-admin, hanya satu URL, atau hanya ketika menjalankan tindakan tertentu. Perbedaan tersebut membantu menentukan apakah sumber masalah berada pada web server, PHP, database, plugin, tema, browser, atau jaringan.

Gejala yang Perlu Dicatat

• Pesan error lengkap, termasuk kode HTTP, nama file, nomor baris, atau request yang gagal.
• Waktu kejadian dan perubahan terakhir seperti update, migrasi, instalasi plugin, perubahan PHP, atau pemasangan SSL.
• Apakah error juga muncul ketika cache browser, plugin cache, CDN, dan proxy dilewati.
• Apakah masalah dapat direproduksi pada staging atau hanya terjadi di server produksi.

Penyebab yang Paling Relevan

• Versi php tidak didukung.
• Class/function bentrok.
• Extension hilang.
• Plugin mengasumsikan dependency lain aktif.

Langkah Diagnosis

1. Gunakan email recovery mode.
2. Baca stack trace.
3. Cek requirements plugin.
4. Lint file jika plugin custom.

Aktifkan Log WordPress dengan Aman

Gunakan logging saat diagnosis, tetapi jangan menampilkan detail PHP kepada pengunjung. Tambahkan konfigurasi berikut sebelum baris penghenti pada wp-config.php, lalu nonaktifkan kembali setelah masalah selesai.

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Setelah error direproduksi, periksa wp-content/debug.log dan error log dari panel hosting. Fokus pada entri dengan waktu yang sama, bukan warning lama yang tidak terkait.

Cara Mengatasinya

1. Langkah 1: Deactivate plugin lewat recovery mode/wp-cli.
2. Langkah 2: Install dependency resmi.
3. Langkah 3: Rollback php/plugin sesuai matriks dukungan.
4. Langkah 4: Hubungi vendor dengan trace tanpa data sensitif.

Contoh Konfigurasi atau Perintah

wp plugin deactivate nama-plugin
php -m
php -v

Sesuaikan nama domain, path, username, versi, dan nilai konfigurasi dengan server Anda. Jalankan perintah hanya jika memiliki akses dan memahami dampaknya. Pada shared hosting, tindakan seperti restart service atau perubahan virtual host perlu dilakukan oleh penyedia hosting.

Cara Memastikan Perbaikan Berhasil

Aktivasi ulang di staging tidak memunculkan fatal error dan fungsi plugin dapat dijalankan.

Selain melihat tampilan website, periksa status HTTP, log baru, fungsi login, proses simpan posting, REST API, cron, dan halaman yang menggunakan plugin atau tema terkait. Perbaikan belum dianggap selesai bila error hanya hilang karena komponen utama dimatikan tanpa solusi permanen.

Jika wp-admin Tidak Dapat Dibuka

Gunakan Recovery Mode bila WordPress mengirim email fatal error. Alternatif lain adalah WP-CLI atau File Manager untuk menonaktifkan komponen yang jelas disebut pada stack trace. Rename folder sebaiknya hanya digunakan sebagai langkah pemulihan sementara, lalu status plugin atau tema perlu dirapikan setelah dashboard dapat dibuka.

Hal yang Sebaiknya Tidak Dilakukan

• Jangan memakai permission 777 sebagai solusi permanen.
• Jangan menonaktifkan pemeriksaan SSL, firewall, atau validasi keamanan secara global hanya untuk menghilangkan pesan error.
• Jangan menghapus tabel, folder uploads, atau file konfigurasi sebelum memiliki backup dan mengetahui pemilik datanya.
• Jangan menaikkan memory, timeout, worker, atau resource tanpa memeriksa proses yang menghabiskannya.
• Jangan mengedit file core WordPress untuk memperbaiki plugin atau tema.

Pencegahan

Sediakan staging, backup yang pernah diuji restore, pencatatan perubahan, monitoring uptime, dan pembaruan terjadwal. Gunakan plugin dan tema dari sumber tepercaya, hapus komponen yang tidak dipakai, batasi hak akses, serta pantau Site Health dan log server. Dengan prosedur tersebut, cara mengatasi fatal error setelah instal plugin dapat didiagnosis lebih cepat tanpa menebak-nebak.

Kesimpulan

Cara Mengatasi Fatal Error Setelah Instal Plugin harus diselesaikan dari bukti teknis: pesan lengkap, log pada waktu kejadian, status HTTP, serta perubahan terakhir. Ikuti diagnosis dari lapisan paling dekat dengan gejala, lakukan satu perubahan pada satu waktu, lalu verifikasi kembali seluruh fungsi terkait sebelum menutup masalah.