Troubleshooting the "Missing MySQL Extension" Error in WordPress

WordPress stops with "Your PHP installation appears to be missing the MySQL extension which is required by WordPress" when PHP cannot give it a way to talk to the database. The fix depends on why: a very old copy of WordPress, a site running on a different PHP version than you think, or, on your own server, a PHP database extension that was never installed. This guide shows how to find which one it is and fix it.

1. What the error means

PHP had two ways to talk to MySQL: the old mysql extension and the newer mysqli (plus PDO). The old mysql extension was deprecated in PHP 5.5 and removed completely in PHP 7.0. WordPress switched to mysqli in version 3.9, released in 2014, and modern WordPress uses only mysqli.

When WordPress starts, it checks that one of these is available. If neither is, it stops with the "missing the MySQL extension" message, and recent versions add "Please check that the mysqli PHP extension is installed and enabled."

2. Check which PHP version really runs your site

Create a file called check-db.php in your site's main folder (public_html on cPanel) with File Manager:

<?php
echo 'PHP ' . PHP_VERSION . '<br>';
echo 'mysqli: ' . (extension_loaded('mysqli') ? 'loaded' : 'MISSING');

Open https://yourdomain.com/check-db.php in your browser, note the two lines, then delete the file. (phpinfo() is disabled on our cPanel servers, so use this test instead.)

3. Very old WordPress on a modern PHP

This is the most common cause after a server or PHP upgrade: a site that has not been updated for years, running WordPress older than 3.9, which looks only for the old mysql functions. Your database is fine; the WordPress code cannot use it.

Do not try to fix this by switching the site back to PHP 5. Those versions have had no security fixes for years. Update WordPress by hand instead:

4. On Domain India shared hosting: fix the PHP version

We checked the PHP builds on our cPanel and DirectAdmin servers on 24 September 2026: mysqli is loaded on every PHP version from 7.0 to 8.5 on cPanel, and on every version DirectAdmin offers. So if your test shows mysqli missing or an unexpected version, the site is not running the PHP you intended.

• Choose the version in your panel. In cPanel open MultiPHP Manager, tick the domain and pick a current PHP 8 version your theme and plugins support. See how to change PHP versions in cPanel. For DirectAdmin, see changing the PHP version in DirectAdmin.
• Look for an old handler line. Sites moved from another host often carry an AddHandler or SetHandler line in .htaccess that forces a different PHP. On cPanel, keep only the block marked "cPanel-generated handler" and remove the others (download a copy of .htaccess first).
• Run the test file again. When it shows a PHP 8 version with mysqli loaded, reload your site.

If the test still shows mysqli missing on a current PHP version, open a support ticket with the test output and the domain name. You cannot install PHP extensions yourself on shared hosting.

5. On your own VPS or server

On a server you manage, the PHP MySQL extension is a separate package that a minimal install may not include.

# Ubuntu / Debian (package name follows your PHP version)
sudo apt install php8.3-mysql
sudo systemctl restart php8.3-fpm

# AlmaLinux / Rocky Linux
sudo dnf install php-mysqlnd
sudo systemctl restart php-fpm

Then confirm with php -m | grep -i mysqli. The command line and the web server can use different PHP versions on the same machine, so check with the test file from section 2 as well. If you run Apache with PHP-FPM, restart Apache too if the change does not show.

6. Keep it from coming back

• Keep WordPress core, themes and plugins updated, or turn on automatic updates for minor releases.
• Stay on a supported PHP 8 version; old versions get no security fixes and run slower. WordPress lists its current recommendation at wordpress.org/about/requirements.
• Test before you switch PHP versions: take a backup, switch, then check your key pages, forms and checkout.

7. Where Domain India fits

Domain India cPanel and DirectAdmin hosting let you choose the PHP version per account and include weekly JetBackup backups you can restore yourself, and every Linux shared plan has an installer for a fresh, current WordPress. If you are moving an old site to us, our WordPress hosting page shows the plans.

Frequently asked questions

Ready to fix it? Check your PHP version with MultiPHP Manager, work through database troubleshooting, or read the complete WordPress guide. If you are stuck, open a support ticket.