ionCube Loader Installation Guide (PHP 8.1 โ€“ 8.3)

  • /

23rd Apr, 2025

๐Ÿ”ง ionCube Loader Installation Guide (PHP 8.1 โ€“ 8.3)


๐Ÿ“Œ What is ionCube Loader?

ionCube Loader is a PHP extension used to run files encoded by the ionCube Encoder. It is required to run encrypted PHP applications like InfixEdu.


For VPS Server:


โœ… Prerequisites
  • Access to your server (root/SSH or hosting panel)
  • PHP version: 8.1, 8.2, or 8.3
  • Basic knowledge of editing php.ini file

๐Ÿ“ฅ Step 1: Download ionCube Loader

Visit the official ionCube Loader Downloads page and download the appropriate version for your system:

  • Linux (64-bit)
  • macOS
  • Windows (for XAMPP/WAMP)
  • cPanel/WHM-based servers

๐Ÿ“ฆ Step 2: Extract the Files
tar -xzf ioncube_loaders_lin_x86-64.tar.gz
cd ioncube

๐Ÿ” Step 3: Locate Your PHP Extensions Directory
php -i | grep extension_dir

Example Output: /usr/lib/php/20220829


๐Ÿ“ Step 4: Copy the Loader File

Find the correct loader file for your PHP version:

PHP Version Loader File
8.1 ioncube_loader_lin_8.1.so
8.2 ioncube_loader_lin_8.2.so
8.3 ioncube_loader_lin_8.3.so

Copy the file to your PHP extension directory:

sudo cp ioncube_loader_lin_8.2.so /usr/lib/php/20220829/

Replace the loader filename and path based on your PHP version.


โœ๏ธ Step 5: Edit php.ini

Edit your php.ini file (you can find the path by running php --ini) and add the following line at the top:

zend_extension=ioncube_loader_lin_8.2.so

Replace with your corresponding loader version.


๐Ÿ”„ Step 6: Restart Web Server
  • Apache:
sudo systemctl restart apache2
  • Nginx + PHP-FPM:
sudo systemctl restart php8.2-fpm
sudo systemctl restart nginx

๐Ÿงช Step 7: Verify Installation

Run:

php -v

Expected output:

PHP 8.2.x (cli) ...
with the ionCube PHP Loader (enabled) ...


๐Ÿ”ง aaPanel

โœ… Standard Installation via Extension Tab
  1. Log in to aaPanel.

  2. Go to App Store > PHP > Settings.

  3. Under Install Extensions, search for ioncube.

  4. Click Install next to it.

  5. Restart the PHP service.


๐Ÿ”ง hPanel (Hostinger)

  1. Log in to hPanel.

  2. Navigate to Advanced > PHP Configuration.

  3. Choose the correct PHP version.

  4. Scroll down to the extensions list, enable ioncube_loader.

  5. Click Save and wait for the changes to apply.


๐Ÿ”ง cPanel

Most shared hosting providers using cPanel have IonCube Loader pre-installed. If not, you can enable it from Select PHP Version or PHP Extensions:

  1. Log in to your cPanel account.

  2. Scroll down to Software and click Select PHP Version.

  3. On the new page, ensure you're using the required PHP version (e.g., 8.1 or 8.2).

  4. Check the box next to ioncube_loader.

  5. Click Save or Apply to activate it.

If you don't see the "Select PHP Version" option, contact your hosting provider for IonCube support.




โ“ Troubleshooting
  • Ensure the loader file matches the exact PHP version.
  • Place the zend_extension line at the top of your php.ini file.
  • Double-check permissions on the .so file.
  • Restart the correct PHP service based on your server.
Categories