PHP Extensions "pdo_mysql" must be loaded

PHP Extensions "pdo_mysql" must be loaded

July 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
PHP Extensions "pdo_mysql" must be loaded

Troubleshooting the “pdo_mysql” Error in Magento Installation

Are you facing difficulty while installing Magento on PHP 5.6 with MySQL? Have you encountered the error message “PHP Extensions ‘pdo_mysql’ must be loaded”? This is a common issue that can be resolved by following these steps.

Understanding the pdo_mysql Extension

The PDO_MYSQL extension allows PHP to interact with the MySQL database using the PHP Data Objects (PDO) interface. If this extension is not enabled, your PHP installation won’t be able to establish a connection to your MySQL server during the Magento installation process.

Checking the Existing Configuration

First, let’s ensure that the pdo_mysql extension is indeed absent from your current configuration. Open both of these files using a text editor:

  • /etc/php/5.6/apache2/php.ini
  • /etc/php/5.6/cli/php.ini

Search for the line extension=pdo_mysql.so. If it’s not present, proceed to the next step.

Enabling the pdo_mysql Extension

To enable this extension, you need to add or uncomment the following line at the end of these files:

; extension=pdo_mysql.so  // Uncomment this line

Then, save and close the files. The semicolon (;) before extension acts as a comment in PHP configurations, so removing it will enable the extension.

Restarting the Apache Server

After updating the configuration files, you need to restart your Apache server for the changes to take effect:

sudo systemctl restart apache2

This command restarts the Apache service, which reloads the updated php.ini file with the enabled extension.

Verifying the Installation

Now, try completing the Magento installation again. If you’ve followed these steps correctly and there are no typos or syntax errors in your configuration files, the “pdo_mysql” error should be resolved.

Remember, always double-check your configurations for any typos that might prevent the changes from taking effect. Also, ensure that the MySQL server is running and reachable from your PHP installation.

Conclusion

Enabling the PDO_MYSQL extension in PHP is a straightforward process that requires adding or uncommenting a single line in the php.ini file and restarting the Apache service. This resolution should help you successfully complete your Magento installation without encountering any “pdo_mysql” errors.

If you’re still facing issues, consider checking our comprehensive guide on Magento Installation Best Practices for a more detailed walkthrough of the entire process.

Database API Extensions Configuration

Our network