Ioncube Installation Tutorial

From WHMCS Documentation

ionCube Loader® is an extension for PHP that allows the system to decode and execute encoded files. Encoded files execute and load faster, giving better performance results for WHMCS. ionCube Loader is a requirement for running WHMCS.

Installing ionCube Loader

For Linux applications, installation requires root access to the server. If you do not have root access and your server does not have ionCube Loader already, contact your hosting provider for assistance. If you do not know whether you have ionCube Loader, you can check by creating a phpinfo page and visiting it in your browser

<?php phpinfo(); ?>

cPanel & WHM

You can use two methods to install ionCube Loader on a cPanel & WHM server:

To install via WHM:

  1. Go to WHM >> EasyApache.
  2. Find ioncubeXX in the PHP Extensions list, where XX is the ionCube Loader version.
  3. Select the correct package for your PHP version.
  4. Finalize the installation.

To install via SSH:

  1. SSH in to your server as the root user.
  2. Run the following command, where YY is the desired PHP version:
    yum install ea-phpYY-php-ioncubeXX

Other Servers

To install ionCube Loader on other servers:

  1. Download the latest supported ionCube Loader.
  2. Extract the contents of the archived file on your local computer.
  3. Upload the IONCUBE folder via FTP to your domain.
  4. Establish an SSH connection with the server using a suitable client (for example, PuTTY or Terminal). Usually, this requires you to run the following command and supply your password:
    SSH rootusername@example.com
  5. Browse to the public folder that contains the IONCUBE directory.
  6. Move the folder to a permanent location:
    mv ioncube /usr/local
  7. Locate the php.ini file:
    locate php.ini
    Usually, you can find it at /usr/local/lib/php.ini.
  8. Edit the file using your preferred editor.
  9. Find the other Zend extensions (zend_extension).
  10. Add a new line for ionCube Loader:
    zend_extension = /usr/local/ioncube/ioncube_loader_lin_x.so
    Replace x with your version of PHP.
  11. Save the changes.
  12. Restart the server:
    /etc/init.d/httpd restart

To verify that installation was successful, check the PHP Info output for your server. You should see a new section:

Additional Modules
Module Name ionCube Loader

WHMCS Support cannot assist with any ionCube Loader problems you may be continuing to have. For help, contact ionCube support directly.