MultiPortal requires a minimum or latest version of ionCube Loader for certain updates.
You will always be informed prior to upgrading if an ionCube update is required.
Current required version as of 1.1.1 is ionCube v15.0.0
Before performing any update that specifies an ionCube requirement, you must verify your installed ionCube Loader version and upgrade it if necessary.
Failure to do so may result in application errors or a failed update.
Run the following command:
php -v
Example output:
PHP 8.2.29 (cli) (built: Jul 3 2025 13:07:49) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.29, Copyright (c) Zend Technologies
with the ionCube PHP Loader v13.0.2, Copyright (c) 2002-2023, by ionCube Ltd.
with Zend OPcache v8.2.29, Copyright (c), by Zend Technologies
If the output does not display an ionCube Loader version that meets the stated update requirements, ionCube must be upgraded before continuing.
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz
Extract the archive:
tar -xzf ioncube_loaders_lin_x86-64.tar.gz
cd ioncube
Identify the path of the currently loaded ionCube module:
cat /etc/php/8.2/fpm/php.ini | grep ioncube_loader_lin_8.2
Example output:
/usr/lib/php/20220829/ioncube_loader_lin_8.2.so
This is the location where the ionCube loader file must be updated.
Copy the appropriate loader file for your PHP version from the extracted archive to the path identified above, replacing the existing file.
sudo cp ioncube_loader_lin_8.2.so /usr/lib/php/20220829/ioncube_loader_lin_8.2.so
Restart PHP-FPM to apply the change:
sudo systemctl restart php8.2-fpm
Re-run the version check:
php -v
You should now see the updated version
PHP 8.2.29 (cli) (built: Jul 3 2025 13:08:18) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.29, Copyright (c) Zend Technologies
with the ionCube PHP Loader v15.0.0, Copyright (c) 2002-2025, by ionCube Ltd.
with Zend OPcache v8.2.29, Copyright (c), by Zend Technologies
Confirm that the ionCube Loader version now matches the version required by the update you are performing.
Once verified, you may proceed with the application update.