Fix "Site Error: The ionCube PHP Loader Needs to Be Installed" on VPS

If you're using a VPS or dedicated server and see the error "Site Error: The ionCube PHP Loader Needs to Be Installed", you need to install ionCube Loader manually via SSH. This guide provides step-by-step instructions for VPS users.

Common Error Message:
"This site requires the ionCube PHP Loader to be installed. Please contact your hosting provider for assistance."

1 Check If ionCube Loader Is Already Installed

Before installing, check if ionCube Loader is already available on your VPS.

Run This Command in SSH:

php -v

Expected Output (if ionCube is installed):

    PHP 8.1.10 (cli) (built: Aug 10 2023 19:27:50) ( NTS )
    Copyright (c) The PHP Group
    Zend Engine v4.1.10, Copyright (c) Zend Technologies
        with the ionCube PHP Loader v12.0, Copyright (c) 2002-2023, by ionCube Ltd.
  

If the "with the ionCube PHP Loader" line is missing, ionCube needs to be installed.

Alternative Check Method:

php -m | grep -i ioncube

If this returns no output, ionCube is not installed.

2 Install ionCube Loader Manually on VPS

Download ionCube Loader

Connect to your VPS via SSH and run:

wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz

Note: If your VPS uses 32-bit architecture, use ioncube_loaders_lin_x86.tar.gz instead.

Extract the Archive

tar -xvzf ioncube_loaders_lin_x86-64.tar.gz
cd ioncube

This will create an "ioncube" directory containing loader files for different PHP versions.

3 Find Your PHP Version

php -v

Example Output:

PHP 8.1.10 (cli) (built: Aug 10 2023 19:27:50) ( NTS )

Make sure to install the correct ionCube version for your PHP version.

PHP Version to ionCube Loader Mapping:
• PHP 8.3 > ioncube_loader_lin_8.3.so
• PHP 8.2 > ioncube_loader_lin_8.2.so
• PHP 8.1 > ioncube_loader_lin_8.1.so
• PHP 8.0 > ioncube_loader_lin_8.0.so
• PHP 7.4 > ioncube_loader_lin_7.4.so
• PHP 7.3 > ioncube_loader_lin_7.3.so
• PHP 7.2 > ioncube_loader_lin_7.2.so
• PHP 7.1 > ioncube_loader_lin_7.1.so
• PHP 7.0 > ioncube_loader_lin_7.0.so

4 Find Your PHP Extensions Directory

php -i | grep extension_dir

Example Output:

extension_dir => /usr/lib/php/20210902 => /usr/lib/php/20210902

This is where the ionCube loader file should be placed. Common directories include:

/usr/lib/php/20210902/ (PHP 8.1)
/usr/lib/php/20200930/ (PHP 8.0)
/usr/lib/php/20190902/ (PHP 7.4)
/usr/lib/php/20180731/ (PHP 7.3)
/opt/plesk/php/8.1/lib/php/modules/ (Plesk)
/usr/local/lib/php/extensions/ (Custom installations)

5 Copy the Correct ionCube Loader File

Step 1: List Available Loader Files

ls -la ioncube/

Look for the loader file matching your PHP version.

Step 2: Copy Loader to PHP Extensions Directory

For PHP 8.1:

sudo cp ioncube/ioncube_loader_lin_8.1.so /usr/lib/php/20210902/

Replace the path with your actual PHP extension directory and version.

Step 3: Set Correct Permissions

sudo chmod 644 /usr/lib/php/20210902/ioncube_loader_lin_8.1.so

6 Enable ionCube Loader in php.ini

Find Your php.ini File

php --ini | grep "Loaded Configuration File"

Example Output:

Loaded Configuration File: /etc/php/8.1/cli/php.ini

Important: You need to edit the php.ini file used by your web server, not just the CLI php.ini:

Apache: /etc/php/8.1/apache2/php.ini
Nginx with PHP-FPM: /etc/php/8.1/fpm/php.ini
CentOS/Apache: /etc/php.ini

Edit php.ini

For Apache (adjust path as needed):

sudo nano /etc/php/8.1/apache2/php.ini

Add this line in the Dynamic Extensions section (usually around line 900-1000):

zend_extension=/usr/lib/php/20210902/ioncube_loader_lin_8.1.so

Important: Use zend_extension not extension. ionCube is a Zend extension, not a regular PHP extension.

Save the file (CTRL + X, then Y, then Enter).

7 Restart Apache or PHP-FPM

If Using Apache:

sudo systemctl restart apache2

If Using Nginx with PHP-FPM:

sudo systemctl restart php8.1-fpm
sudo systemctl restart nginx

If Using Lighttpd:

sudo systemctl restart lighttpd

If Using Plesk:

sudo plesk bin php_handler --reread

8 Verify ionCube Installation

Check ionCube in PHP CLI

php -m | grep ionCube

Expected Output:

ionCube Loader

Create PHP Info File for Browser Verification

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

Or for specific user directory (if using ISPmanager/cPanel/etc.):

echo "<?php phpinfo(); ?>" > /home/user/domains/yourdomain.com/public_html/info.php

Access PHP Info in Browser

Open your browser
Navigate to:
https://yourdomain.com/info.php
Search for "ionCube Loader" using Ctrl+F
You should see ionCube information in the Zend Engine section

Remove PHP Info File (Security)

After verification, remove the info.php file:

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

9 Troubleshooting ionCube Loader Issues

Issue	Fix
"Site error: ionCube Loader needs to be installed"	Check php.ini and confirm the correct loader file is loaded. Verify web server restart.
ionCube not showing in PHP info	Restart Apache (`sudo systemctl restart apache2`) or PHP-FPM (`sudo systemctl restart php8.1-fpm`).
Wrong PHP version detected	Ensure you installed the correct ionCube loader for your PHP version. Check with `php -v`.
PHP Fatal error: Unable to load dynamic library	Check the `zend_extension` path in php.ini. Verify file exists with correct permissions.
ionCube works in CLI but not browser	Edit web server's php.ini (apache2/fpm), not just cli php.ini.
Loader file not found	Check extension directory path. Use `php -i \| grep extension_dir` to confirm.
Multiple PHP versions installed	Install ionCube for each PHP version and edit corresponding php.ini files.

10 Summary

Task	Command/Action
Check ionCube Installation	`php -v` or `php -m \| grep ionCube`
Download ionCube	`wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz`
Extract Archive	`tar -xvzf ioncube_loaders_lin_x86-64.tar.gz && cd ioncube`
Find PHP Version	`php -v`
Find PHP Extension Directory	`php -i \| grep extension_dir`
Copy ionCube Loader File	`sudo cp ioncube/ioncube_loader_lin_X.X.so /path/to/extensions/`
Edit php.ini	Add `zend_extension=/path/to/ioncube_loader_lin_X.X.so`
Restart Server	`sudo systemctl restart apache2` or `php-fpm`
Verify Installation	Use `phpinfo();` in browser and search for "ionCube Loader"

Now your ionCube Loader is installed and your website should work without errors!

Fix: "Site Error: The ionCube PHP Loader Needs to Be Installed" (VPS/SSH Users)

1 Check If ionCube Loader Is Already Installed

Run This Command in SSH:

Alternative Check Method:

2 Install ionCube Loader Manually on VPS

Download ionCube Loader

Extract the Archive

3 Find Your PHP Version

4 Find Your PHP Extensions Directory

5 Copy the Correct ionCube Loader File

Step 1: List Available Loader Files

Step 2: Copy Loader to PHP Extensions Directory

Step 3: Set Correct Permissions

6 Enable ionCube Loader in php.ini

Find Your php.ini File

Edit php.ini

7 Restart Apache or PHP-FPM

If Using Apache:

If Using Nginx with PHP-FPM:

If Using Lighttpd:

If Using Plesk:

8 Verify ionCube Installation

Check ionCube in PHP CLI

Create PHP Info File for Browser Verification

Access PHP Info in Browser

Remove PHP Info File (Security)

9 Troubleshooting ionCube Loader Issues

10 Summary

High-Availability Cloud VDS

Hosting

Cloud Solution

For You

VDS

Website Builders

Our services

Client Area

Select Currency

Fix: "Site Error: The ionCube PHP Loader Needs to Be Installed" (VPS/SSH Users)

1 Check If ionCube Loader Is Already Installed

Run This Command in SSH:

Alternative Check Method:

2 Install ionCube Loader Manually on VPS

Download ionCube Loader

Extract the Archive

3 Find Your PHP Version

4 Find Your PHP Extensions Directory

5 Copy the Correct ionCube Loader File

Step 1: List Available Loader Files

Step 2: Copy Loader to PHP Extensions Directory

Step 3: Set Correct Permissions

6 Enable ionCube Loader in php.ini

Find Your php.ini File

Edit php.ini

7 Restart Apache or PHP-FPM

If Using Apache:

If Using Nginx with PHP-FPM:

If Using Lighttpd:

If Using Plesk:

8 Verify ionCube Installation

Check ionCube in PHP CLI

Create PHP Info File for Browser Verification

Access PHP Info in Browser

Remove PHP Info File (Security)

9 Troubleshooting ionCube Loader Issues

10 Summary

High-Availability Cloud VDS

Hosting

Cloud Solution

For You

VDS

Website Builders

Our services

Client Area

Выберите валюту