Difference between revisions of "Ioncube Installation Tutorial"

From WHMCS Documentation
(→‎cPanel & WHM)
 
(6 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
=About IonCube Loaders=
+
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.
  
 +
== Installing ionCube Loader ==
  
−
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.
+
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
−
=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
 
  
 
<source lang="php">
 
<source lang="php">
Line 11: Line 9:
 
</source>
 
</source>
  
−
==For cPanel==
+
=== cPanel & WHM ===
  
−
Installing IonCube Loaders with cPanel & WHM can be done one of two ways:
+
You can use two methods to install ionCube Loader on a cPanel & WHM server:
  
−
1) Using EasyApache via WHM >> EasyApache, IonCube Loaders can be selected under the Exhaustive Options List prior to compiling.
+
To install via WHM:
  
−
2) As the user `root` via SSH, you can run the below command to install IonCube Loaders without having to recompile Apache:
+
# 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.
  
−
<source lang="php">
+
To install via SSH:
−
/scripts/phpextensionmgr install IonCubeLoader
+
 
−
</source>
+
# 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 ===
  
−
==For Non-Control panel Servers==
+
To install ionCube Loader on other servers:
  
−
#Begin by downloading the latest loaders to your computer from http://www.ioncube.com/loaders.php
+
# Download [http://www.ioncube.com/loaders.php the latest supported ionCube Loader].
−
#Extract the contents of the archived file on your local PC to a folder of your choice.
+
# Extract the contents of the archived file on your local computer.
−
#Upload the folder IONCUBE via FTP to your domain webspace
+
# Upload the <tt>IONCUBE</tt> folder via FTP to your domain.
−
#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).
+
# 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>
−
#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).
+
# Browse to the public folder that contains the <tt>IONCUBE</tt> directory.
−
#Move the ioncube folder to a permanent location by entering: mv ioncube /usr/local
+
# Move the folder to a permanent location: <source lang="bash">mv ioncube /usr/local</source>
−
#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
+
# 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>.  
−
#Now find where other zend extentions are in the file: ctrl + w: zend_extension
+
# Edit the file using your preferred editor.
−
#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)
+
# Find the other Zend extensions (<tt>zend_extension</tt>).
−
#Save the changes: ctrl + X then Y and enter
+
# 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.
−
#Restart the web server to take effect: /etc/init.d/httpd restart  
+
# Save the changes.
 +
# Restart the server: <source lang="bash">/etc/init.d/httpd restart </source>
  
−
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:
+
To verify that installation was successful, check the PHP Info output for your server. You should see a new section:
  
 
  Additional Modules
 
  Additional Modules
Line 43: Line 48:
  
 
<div class="docs-alert-danger">
 
<div class="docs-alert-danger">
−
<span class="title">Note</span><br />
+
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.
−
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>
 
</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"