Step 1: Determine your PHP version and configuration
php -v
php -i | grep "extension_dir"
php -i | grep "architecture"Note your PHP version (e.g., 7.4, 8.0) and whether it's 32-bit or 64-bit.
Step 2: Download the appropriate ionCube Loaders package
Visit the official ionCube website: https://www.ioncube.com/loaders.php Download the package that matches your:
- Server operating system (Linux, Windows, macOS)
- PHP version
- Architecture (32-bit or 64-bit)
Step 3: Upload and extract the package
For Linux servers:
mkdir ~/ioncube
cd ~/ioncube
# Upload the downloaded package here
tar -xvzf ioncube_loaders_*.tar.gzStep 4: Find the correct loader file
Locate the loader file for your PHP version. It will have a name like:
ioncube_loader_lin_7.4.so(for Linux, PHP 7.4)ioncube_loader_win_7.4.dll(for Windows, PHP 7.4)
Step 5: Copy the loader to the PHP extension directory
sudo cp ioncube/ioncube_loader_lin_7.4.so /path/to/php/extensions/Replace the filename and path with your actual PHP extension directory.
Step 6: Configure PHP to use the loader
Edit your php.ini file:
sudo nano /path/to/php.iniAdd this line at the beginning of the file (before any other extension):
zend_extension = /path/to/php/extensions/ioncube_loader_lin_7.4.soAlternatively, if your server uses separate configuration files:
sudo nano /path/to/php/conf.d/00-ioncube.iniAnd add:
zend_extension = /path/to/php/extensions/ioncube_loader_lin_7.4.soStep 7: Restart web server
sudo systemctl restart apache2 # For Apache on Ubuntu/Debian
sudo systemctl restart httpd # For Apache on CentOS/RHELStep 8: Verify installation
Create a PHP file with the following content:
<?php phpinfo(); ?>Access it through your web browser and look for "ionCube" in the output.
Common issues:
- Wrong loader for PHP version: Make sure the loader exactly matches your PHP version
- Incorrect path: Verify your PHP extension directory path
- Permission issues: Ensure the loader file has read permissions
- Load order: ionCube should be loaded before other Zend extensions
For cPanel environments, you can often install ionCube Loaders directly through the PHP Selector or PHP Configuration interface.