Ioncube Installation Tutorial

From WHMCS Documentation

Revision as of 15:44, 17 September 2014 by John (talk | contribs)

About IonCube Loaders

IonCube Loaders is an encryption/decryption utility for PHP applications which also assists in speeding up the pages that are served. IonCube Loaders is one of the requirements for running WHMCS.

Installing IonCube Loaders

For Linux applications, root access to the server is required. If you do not have root access and your server does not have IonCube Loaders installed, please contact your hosting provider for assistance. If you do not know if you have IonCube Loaders installed, you can check by creating a PHPInfo page and visiting it in your web browser

<?php phpinfo(); ?>

For cPanel

Installing IonCube Loaders with cPanel & WHM can be done one of two ways:

1) Using EasyApache via WHM >> EasyApache, IonCube Loaders can be selected under the Exhaustive Options List prior to compiling.

2) As the user `root` via SSH, you can run the below command to install IonCube Loaders without having to recompile Apache:

/scripts/phpextensionmgr install IonCubeLoader

For Non-Control panel Servers

  1. Begin by downloading the latest loaders to your computer from
  2. Extract the contents of the archived file on your local PC to a folder of your choice.
  3. Upload the folder IONCUBE via FTP to your domain webspace
  4. Now establish an SSH connection with server using a suitable client (e.g. Putty for PC's or Terminal on Mac). This is usually done using the command: SSH (you will then be asked for your password).
  5. You will need to browse to the public folder where you uploaded the IONCUBE directory (search internet for change and view directory commands in Unix).
  6. Move the ioncube folder to a permanent location by entering: mv ioncube /usr/local
  7. Next, you need to locate the php.ini file, to do this enter: locate php.ini - You should find it is in /usr/local/lib/php.ini. Now that you know the location of php.ini you need to edit it. pico /usr/local/lib/php.ini
  8. Now find where other zend extentions are in the file: ctrl + w: zend_extension
  9. Paste in your new line for ioncube loader: zend_extension = /usr/local/ioncube/ (Replace x with your version of PHP eg. 4.4)
  10. Save the changes: ctrl + X then Y and enter
  11. Restart the web server to take effect: /etc/init.d/httpd restart

That's it! Ioncube should now be installed & working on your server. To verify the installation was successful, check the PHP Info output for your server and you should see a new section which reads:

Additional Modules
Module Name ionCube Loader

If you are still having Ioncube issues the WHMCS support team are unable to assist with this. Instead please contact Ioncube support directly.