Difference between revisions of "Ioncube Installation Tutorial"

From WHMCS Documentation
(→‎cPanel & WHM)
 
(10 intermediate revisions by 6 users not shown)
Line 1: Line 1:
−
To install Ioncube you will require root access to the server as it must be done via SSH. Here's how:
+
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 [[System Environment Guide|requirement]] for running WHMCS.
  
−
#Begin by downloading the latest loaders to your computer from http://www.ioncube.com/loaders.php
+
== Installing ionCube Loader ==
−
#Extract the contents of the archived file on your local PC to a folder of your choice.
 
−
#Upload the folder IONCUBE via FTP to your domain webspace
 
−
#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 rootusername@yourserver.com (you will then be asked for your password).
 
−
#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).
 
−
#Move the ioncube folder to a permanent location by entering: mv ioncube /usr/local
 
−
#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
 
−
#Now find where other zend extentions are in the file: ctrl + w: zend_extension
 
−
#Paste in your new line for ioncube loader: zend_extension = /usr/local/ioncube/ioncube_loader_lin_x.so (Replace x with your version of PHP eg. 4.4)
 
−
#Save the changes: ctrl + X then Y and enter
 
−
#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:
+
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 <tt>phpinfo</tt> page and visiting it in your browser
 +
 
 +
<source lang="php">
 +
<?php phpinfo(); ?>
 +
</source>
 +
 
 +
=== cPanel & WHM ===
 +
 
 +
You can use two methods to install ionCube Loader on a cPanel & WHM server:
 +
 
 +
To install via WHM:
 +
 
 +
# Go to '''WHM >> EasyApache'''.
 +
# Find '''ioncubeXX''' in the '''PHP Extensions''' list, where <tt>XX</tt> is the ionCube Loader version.
 +
# Select the correct package for your PHP version.
 +
# Finalize the installation.
 +
 
 +
To install via SSH:
 +
 
 +
# SSH in to your server as the <tt>root</tt> user.
 +
# Run the following command, where <tt>YY</tt> is the desired PHP version: <source lang="bash">yum install ea-phpYY-php-ioncubeXX</source>
 +
 
 +
=== Other Servers ===
 +
 
 +
To install ionCube Loader on other servers:
 +
 
 +
# Download [http://www.ioncube.com/loaders.php the latest supported ionCube Loader].
 +
# Extract the contents of the archived file on your local computer.
 +
# Upload the <tt>IONCUBE</tt> folder via FTP to your domain.
 +
# 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: <source lang="bash">SSH rootusername@example.com</source>
 +
# Browse to the public folder that contains the <tt>IONCUBE</tt> directory.
 +
# Move the folder to a permanent location: <source lang="bash">mv ioncube /usr/local</source>
 +
# Locate the <tt>php.ini</tt> file: <source lang="bash">locate php.ini</source> Usually, you can find it at <tt>/usr/local/lib/php.ini</tt>.
 +
# Edit the file using your preferred editor.
 +
# Find the other Zend extensions (<tt>zend_extension</tt>).
 +
# Add a new line for ionCube Loader: <source lang="bash">zend_extension = /usr/local/ioncube/ioncube_loader_lin_x.so</source> Replace <tt>x</tt> with your version of PHP.
 +
# Save the changes.
 +
# Restart the server: <source lang="bash">/etc/init.d/httpd restart </source>
 +
 
 +
To verify that installation was successful, check the PHP Info output for your server. You should see a new section:
  
 
  Additional Modules
 
  Additional Modules
 
  Module Name ionCube Loader
 
  Module Name ionCube Loader
  
−
If you are still having Ioncube issues the WHMCS support team are unable to assist with this. Instead please contact [http://support.ioncube.com Ioncube support] directly.
+
<div class="docs-alert-danger">
 +
WHMCS Support cannot assist with any ionCube Loader problems you may be continuing to have. For help, contact [http://support.ioncube.com ionCube support] directly.
 +
</div>

Latest revision as of 14:53, 2 January 2024

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.

Retrieved from "http://3.17.75.209/index.php?title=Ioncube_Installation_Tutorial&oldid=34346"