База на знаења

How to Enable ionCube Loader in WHM/cPanel

ionCube Loader is a PHP extension required by many commercial PHP applications, including WHMCS, Blesta, and various WordPress plugins. This guide shows you how to enable it on your server.

What is ionCube Loader?

ionCube is a PHP encoder that protects PHP source code by compiling it into bytecode. The ionCube Loader is the runtime component that decodes and executes ionCube-encoded files. Without it, encoded applications will display errors.

Method 1: Enable ionCube via WHM (Recommended)

1. Log in to WHM as root.
2. Navigate to Server Configuration > Tweak Settings.
3. Search for "ionCube" or scroll to the PHP section.
4. Set "ioncube" to enabled.
5. Click "Save".

Method 2: Enable via MultiPHP INI Editor

1. In WHM, go to Software > MultiPHP INI Editor.
2. Select the Basic Mode tab.
3. Choose the PHP version you want to modify.
4. Check the box next to "ionCube Loader".
5. Click "Apply".

Method 3: Enable via SSH (Manual)

If the GUI methods do not work, you can enable ionCube manually:

# Find your PHP extension directory
php -i | grep extension_dir

# Download the appropriate ionCube loader
cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz
tar xzf ioncube_loaders_lin_x86-64.tar.gz

# Copy the loader for your PHP version (e.g., PHP 8.1)
cp ioncube/ioncube_loader_lin_8.1.so /usr/local/lib/php/extensions/

# Add to php.ini (must be the FIRST extension loaded)
echo "zend_extension=ioncube_loader_lin_8.1.so" > /etc/php.d/00-ioncube.ini

# Restart Apache/PHP-FPM
systemctl restart httpd

Verify ionCube is Enabled

Create a PHP info page or run from the command line:

php -v

You should see a line mentioning "with the ionCube PHP Loader" in the output.

Troubleshooting

• "Cannot load ionCube" error: Make sure the loader version matches your PHP version exactly.
• "API mismatch" error: You need to recompile or download the correct loader build for your PHP API version.
• ionCube not showing in phpinfo(): Ensure the zend_extension path is correct and restart your web server.