Install ionCube Loader Manually on a VPS (Step-by-Step Guide)

If you're using a VPS and see the error: "The ionCube PHP Loader needs to be installed." It means your PHP installation is missing ionCube Loader, which is required to run encrypted PHP scripts.

For the panel-based install paths (cPanel/Plesk/DirectAdmin), see Fix: "Site Error: The ionCube PHP Loader Needs to Be Installed". For the SSH-focused but condensed variant, Fix: "Site Error: The ionCube PHP Loader Needs to Be Installed" (VPS/SSH Users). For editing php.ini step-by-step, Edit php.ini to Enable ionCube Loader.

Check Your PHP Version

Before installing ionCube, determine your PHP version as ionCube loaders are version-specific.

Step 1: Check PHP Version

php -v

Example Output:

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

Note your PHP version (8.1.10 in this example).

Step 2: Check PHP Architecture

# Check if 32-bit or 64-bit

    uname -m

Output should be:

• x86_64 = 64-bit system
• i386 or i686 = 32-bit system

Step 3: Check Thread Safety

php -i | grep "Thread Safety"

Download ionCube Loader

Step 1: Navigate to Temporary Directory

cd /tmp

Step 2: Download ionCube Loader

For 64-bit systems (most VPS):

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

For 32-bit systems:

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

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

Step 3: Extract the Archive

tar -xvzf ioncube_loaders_lin_x86-64.tar.gz

    cd ioncube

You now have access to all ionCube Loader files for different PHP versions.

Step 4: List Available Loader Files

ls -la *.so

This will show all available ionCube loader files.

Find Your PHP Extensions Directory

Step 1: Find PHP Extension Directory

php -i | grep extension_dir

Example Output:

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

Step 2: Alternative Method to Find Directory

# Using php-config

    php-config --extension-dir


    
    # Using PHP interactive

    php -r "echo ini_get('extension_dir');"

Step 3: Common PHP Extension Directories

Ubuntu/Debian PHP 8.1: /usr/lib/php/20210902/

    Ubuntu/Debian PHP 8.0: /usr/lib/php/20200930/

    Ubuntu/Debian PHP 7.4: /usr/lib/php/20190902/

    CentOS/RHEL: /usr/lib64/php/modules/

    CentOS PHP 7.4: /usr/lib64/php/7.4/modules/

    Custom installations: /usr/local/lib/php/extensions/

Step 4: Verify Directory Exists

ls -la /usr/lib/php/20210902/

You should see other .so files in this directory.

Copy the Correct ionCube Loader File

Step 1: Identify Correct Loader File

Match your PHP version with the correct ionCube loader file:

Step 2: Copy the Loader File

For PHP 8.1 (adjust for your version):

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

Step 3: Set Correct Permissions

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

Step 4: Verify File Copy

ls -la /usr/lib/php/20210902/ioncube_loader_lin_8.1.so

Expected output shows file permissions and size.

Enable ionCube in php.ini

Step 1: Find php.ini File Location

php --ini | grep "Loaded Configuration File"

Example Output:

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

Step 2: Find Web Server php.ini

# Find all php.ini files

    find /etc -name "php.ini" 2>/dev/null


    
    # Check Apache modules

    apache2ctl -M 2>/dev/null | grep php


    
    # Check PHP-FPM status

    systemctl list-units | grep php

Step 3: Edit the Correct php.ini

For Apache:

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

For Nginx with PHP-FPM:

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

Step 4: Add ionCube Loader Line

Navigate to the "Dynamic Extensions" section (usually around line 900-1000) and add:

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

Step 5: Save the File

In nano editor:

1. Press Ctrl + X to exit
2. Press Y to confirm saving
3. Press Enter to keep the same filename

Restart Apache or PHP-FPM

For Apache Web Server:

sudo systemctl restart apache2

    # Check status

    sudo systemctl status apache2

For Nginx with PHP-FPM:

sudo systemctl restart php8.1-fpm

    sudo systemctl restart nginx

    # Check PHP-FPM status

    sudo systemctl status php8.1-fpm

For Lighttpd:

sudo systemctl restart lighttpd

Check Error Logs

# Apache error log

    sudo tail -f /var/log/apache2/error.log


    
    # PHP-FPM error log

    sudo tail -f /var/log/php8.1-fpm.log

Verify ionCube Installation

Method 1: Command Line Check

php -m | grep -i ioncube

Expected Output:

ionCube Loader

Method 2: PHP Version Check

php -v

Look for: with the ionCube PHP Loader vX.X

Method 3: Create PHP Info File

1. Create a test file:

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

2. Access in browser:

   https://yourdomain.com/info.php

3. Search for "ionCube Loader" using Ctrl+F
4. You should see ionCube information
5. Remove file after testing:

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

Method 4: Test ionCube Function

php -r "echo extension_loaded('ionCube Loader') ? '? ionCube Loaded' : '? ionCube NOT loaded';"

Linux VDS

High performance for your projects

• Root access and flexible setup
• Control panel
• NVMe disks
• DDR5

View pricing

Troubleshooting Common Issues