Fix "mcrypt extension needs to be loaded" in OpenCart

Table of Contents: Introduction Check if Mcrypt is Installed Fix for PHP 7.4 or Older Fix for PHP 7.2+ (Sodium Alternative) Enable Mcrypt in PHP.ini Verify Installation Summary of Fixes

1. Check if Mcrypt is Installed

First, diagnose whether the mcrypt extension is available on your system.

php -m | grep mcrypt

Interpretation:

• If you see mcrypt in the output, the extension is installed but might not be properly enabled in your web server's PHP configuration.
• If there's no output, mcrypt is not installed and you need to install it (for older PHP) or use an alternative (for PHP 7.2+).

Also check your PHP version to determine the correct approach:

php -v

2. Install Mcrypt for PHP 7.4 or Older

sudo apt update
sudo apt install php-mcrypt -y

sudo yum install php-mcrypt -y

Restart Web Services

After installation, restart your web server and PHP processor:

# For Apache
sudo systemctl restart apache2

# For Nginx with PHP-FPM
sudo systemctl restart php7.4-fpm  # Adjust version if different
sudo systemctl restart nginx

3. Alternative Fix for PHP 7.2+ (Sodium Extension)

Install Sodium Extension

sudo apt install php-sodium -y

sudo yum install php-pecl-sodium -y

Restart Services

# For Apache
sudo systemctl restart apache2

# For Nginx with PHP-FPM
sudo systemctl restart php7.4-fpm  # Adjust version if different

Modify OpenCart to Use Sodium (If Needed)

If OpenCart still throws mcrypt errors after installing Sodium, you may need to modify its encryption function. First, backup the file!

sudo cp /var/www/html/opencart/system/library/encryption.php /var/www/html/opencart/system/library/encryption.php.backup
sudo nano /var/www/html/opencart/system/library/encryption.php

Find this line (around line 30-40):

$this->key = hash('sha256', $key, true);

Replace it with:

$this->key = sodium_crypto_generichash($key);

Save the file (Ctrl+O, Enter, Ctrl+X) and restart your web server:

sudo systemctl restart apache2   # or nginx

4. Enable Mcrypt in PHP Configuration

If mcrypt is installed but not being loaded by your web server's PHP, you need to enable it in the correct php.ini file.

Find the Correct php.ini File

# For command-line PHP
php --ini | grep "Loaded Configuration File"

# For web PHP (Apache)
sudo find /etc -name "php.ini" | grep apache2

# For web PHP (Nginx/PHP-FPM)
sudo find /etc -name "php.ini" | grep fpm

Edit php.ini

# Example for Apache on Ubuntu/Debian
sudo nano /etc/php/7.4/apache2/php.ini

# Example for PHP-FPM on Ubuntu/Debian
sudo nano /etc/php/7.4/fpm/php.ini

# Example for CentOS/RHEL
sudo nano /etc/php.ini

Find the extension=mcrypt.so line (or similar) and uncomment it by removing the semicolon at the beginning:

;extension=mcrypt.so  # Change this to:
extension=mcrypt.so

If the line doesn't exist, add it to the extensions section.

Restart Services

# For Apache
sudo systemctl restart apache2

# For Nginx with PHP-FPM
sudo systemctl restart php7.4-fpm
sudo systemctl restart nginx

5. Verify That Mcrypt or Sodium is Enabled

After applying your chosen solution, verify the extension is active:

# Check for mcrypt (if using PHP 7.4 or older)
php -m | grep mcrypt

# Check for sodium (if using PHP 7.2+)
php -m | grep sodium

You should see the extension name in the output. Additionally, you can create a simple PHP info file to check web server configuration:

echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/test_phpinfo.php

Visit http://yourdomain.com/test_phpinfo.php in your browser and search for "mcrypt" or "sodium". Remember to delete this file after testing:

sudo rm /var/www/html/test_phpinfo.php

6. Summary of Fixes

Following the appropriate solution based on your PHP version will resolve the "mcrypt extension needs to be loaded" error in OpenCart!