Cara Mengatasi ‘Your PHP Installation Appears to Be Missing the MySQL Extension’ di WordPress cPanel

Bayangkan situasi menegangkan ini: Anda baru saja mengikuti saran artikel teknologi untuk meningkatkan performa kecepatan website bisnis Anda dengan memperbarui versi PHP dari versi lama ke versi modern di cPanel. Namun begitu proses pembaruan selesai dan Anda membuka alamat situs web perusahaan, layar putih kosong menyambut Anda dengan satu baris kalimat yang menakutkan: “Your PHP installation appears to be missing the MySQL extension which is required by WordPress.”

Kepanikan seketika melanda. Banyak pemilik usaha lokal dan pengelola toko online mengira bahwa seluruh tabel database produk, riwayat pesanan pelanggan, dan artikel blog mereka telah terhapus dari server hosting.

Tenang, jangan panik. Pesan peringatan tersebut sama sekali tidak berarti basis data MySQL Anda hilang atau rusak. Pesan tersebut murni memberi tahu bahwa modul jembatan penghubung antara penerjemah bahasa PHP versi baru di server dengan mesin database MySQL Anda sedang berada dalam kondisi nonaktif.

Dengan mengikuti panduan praktis ini, Anda dapat mengaktifkan kembali modul ekstensi database tersebut langsung dari cPanel hanya dalam waktu kurang dari lima menit.

Mengapa Ekstensi MySQL Mendadak Hilang Setelah Update PHP?

WordPress adalah aplikasi berbasis bahasa pemrograman PHP yang membutuhkan perantara khusus untuk membaca dan menulis data ke sistem database MariaDB atau MySQL.

Pada versi PHP versi lawas (PHP generasi 5 ke bawah), fungsi penghubung tersebut menggunakan pustaka modul bernama ext/mysql. Namun, sejak peluncuran PHP versi tujuh dan delapan, ekstensi jadul tersebut telah dihapus secara permanen dari inti bahasa PHP dan digantikan oleh modul modern yang jauh lebih cepat dan aman, yaitu MySQLi (MySQL Improved) serta pustaka PDO MySQL.

Ketika Anda beralih ke versi PHP yang lebih tinggi di cPanel menggunakan alat seperti Select PHP Version (CloudLinux) atau MultiPHP Manager, modul-modul ekstensi baru pada profil versi yang baru tersebut sering kali belum tercentang secara otomatis oleh sistem hosting. Akibatnya, WordPress tidak dapat menemukan saluran komunikasi ke database dan langsung memunculkan pesan galat tersebut ke layar pengunjung.

Berikut langkah perbaikan sistematis yang terbukti efektif mengembalikan situs web Anda beroperasi normal.

Langkah 1: Aktifkan Ekstensi MySQLi Melalui PHP Selector di cPanel

Metode ini adalah cara paling umum yang berlaku pada lebih dari sembilan puluh persen penyedia layanan web hosting shared di Indonesia:

• Masuk ke halaman login cPanel hosting website Anda.
• Pada kolom pencarian di bagian atas, ketik kata kunci Select PHP Version atau buka menu seksi Software, lalu klik Select PHP Version.
• Pastikan Anda berada pada versi PHP yang ingin digunakan (disarankan menggunakan PHP 8.1 atau PHP 8.2 untuk kompatibilitas WordPress modern).
• Klik tab menu Extensions di sebelah kanan atas layar.
• Anda akan melihat daftar panjang modul ekstensi berformat alfabet. Gulir ke bawah hingga menemukan baris huruf M dan P.
• Beri tanda centang (checklist) pada modul-modul krusial berikut:
• mysqli atau nd_mysqli (ekstensi utama penghubung WordPress).
• mysqlnd (pustaka driver bawaan MySQL).
• pdo_mysql atau nd_pdo_mysql (dibutuhkan oleh banyak plugin modern).
• Perhatikan pojok kanan atas layar cPanel. Sistem CloudLinux biasanya akan menyimpan pengaturan secara otomatis (Success / Module saved).

Setelah mencentang modul tersebut, buka tab baru pada browser dan segarkan website Anda. Pada sebagian besar kasus, halaman utama website bisnis Anda akan langsung terbuka kembali dengan sempurna.

Langkah 2: Periksa Pengaturan MultiPHP Manager dan MultiPHP INI Editor

Jika penyedia hosting Anda menggunakan cPanel standar tanpa sistem CloudLinux Selector, pengaturannya berada pada modul MultiPHP:

• Di menu utama cPanel, cari dan klik alat bernama MultiPHP Manager.
• Pastikan domain website bisnis Anda telah diarahkan pada versi PHP yang sesuai (misalnya ea-php81 atau ea-php82).
• Jika modul tetap tidak terbaca, buka menu MultiPHP INI Editor di cPanel.
• Pilih lokasi direktori website Anda (pilih nama domain bisnis Anda dari menu drop-down).
• Pada tab Editor Mode, pastikan tidak ada baris konfigurasi usang yang menonaktifkan fungsi ekstensi dinamis.
• Periksa nilai direktori ekstensi extension_dir agar tetap menggunakan nilai bawaan sistem server tanpa ada modifikasi manual yang salah arah.

Berikut tabel panduan modul PHP esensial yang wajib aktif agar website WordPress bisnis beroperasi stabil tanpa galat koneksi:

Langkah 3: Periksa File php.ini atau user.ini Lokal

Kadang kala, sebuah plugin keamanan atau skrip optimasi lama pernah membuat file konfigurasi PHP lokal di dalam folder utama website Anda:

• Buka menu File Manager di cPanel Anda.
• Masuk ke folder direktori public_html.
• Periksa apakah terdapat file bernama php.ini atau .user.ini.
• Jika file tersebut ada, klik kanan lalu ubah namanya (Rename) menjadi php.ini.bak atau .user.ini.bak.
• File konfigurasi lokal yang usang sering kali menimpa (override) konfigurasi server pusat dan mematikan pemuatan ekstensi baru secara tidak sengaja.
• Lakukan uji coba muat ulang website Anda kembali.

Dengan memastikan bahwa seluruh modul penghubung database telah terpasang rapi sesuai versi PHP yang dipilih, sistem website Anda tidak hanya kembali aktif normal, namun juga menikmati peningkatan kecepatan loading dan efisiensi memori dari teknologi PHP generasi terkini.

—

Menghadapi error teknis server secara mandiri memang sering kali menyita waktu dan energi berharga yang seharusnya bisa Anda curahkan untuk mengembangkan bisnis Anda. Jika Anda merasa ragu dalam melakukan konfigurasi server hosting, sering menemui kendala error database yang membingungkan, atau ingin memperbarui performa website perusahaan agar kencang dan aman dari serangan malware, antond.net hadir menyediakan solusinya. Kami melayani jasa konsultasi teknis, audit keamanan, perbaikan website mendesak, hingga pengelolaan infrastruktur web bisnis terpercaya bagi para pemilik usaha di seluruh Indonesia. Hubungi tim antond.net sekarang untuk konsultasi teknis terbaik.