Documentation

Features

Differences

This shows you the differences between the selected revision and the current version of the page.

troubleshooting:ioncube 2008/08/24 17:40 troubleshooting:ioncube 2008/09/19 14:28 current
Line 1: Line 1:
-====== Ioncube FAQ ======+====== Ioncube Installation ====== 
 + 
 +This guide will hopefully help you install Ioncube on your server if run time loading doesn't work.  
 + 
 +We also have some tutorials for specific hosts below:  
 +  * [[troubleshooting:ioncube:bluehost | Bluehost]] 
 +  * [[troubleshooting:ioncube:godaddy | GoDaddy]]
===== Installing the correct loaders ===== ===== Installing the correct loaders =====
Line 5: Line 11:
There are a couple of things we can check before we choose which Ioncube loader will be right for your site. There are a couple of things we can check before we choose which Ioncube loader will be right for your site.
-**a. Step 1**+==== Step 1 ====
-First, open a browser window and visit www.yoursite.com/ioncube/ioncube-loader-helper.php (replacing 'yoursite' with your site name). Click the link 'run-time loading installation instructions'. The file runs a test to see if it's possible for your system to use a run-time loader.+<nowiki>First, open a browser window and visit www.yoursite.com/ioncube/ioncube-loader-helper.php (replacing 'yoursite' with your site name). Click the link 'run-time loading installation instructions'. The file runs a test to see if it's possible for your system to use a run-time loader.</nowiki>
After completing the test, you should see the test results "Run-time loading should be possible on your system but no suitable Loader was found." If these are not the results you receive from your test, you will need to contact your host because a run-time loader is not possible. Usually, your host will have to either "Turn off 'safe mode'" OR modify the "php.ini" file. When you contact your host, provide the location of the ioncube helper file (www.yoursite.com/ioncube/ioncube-loader-helper.php) so that they can see the results of the test you've just run. After completing the test, you should see the test results "Run-time loading should be possible on your system but no suitable Loader was found." If these are not the results you receive from your test, you will need to contact your host because a run-time loader is not possible. Usually, your host will have to either "Turn off 'safe mode'" OR modify the "php.ini" file. When you contact your host, provide the location of the ioncube helper file (www.yoursite.com/ioncube/ioncube-loader-helper.php) so that they can see the results of the test you've just run.
 +
 +==== Step 2 ====
 +
 +If you received successful results from the ioncube run-time loader test (that is, your results say "Run-time loading should be possible on your system but no suitable Loader was found."), our next step is to determine which of ioncube's run-time loaders are right for your system.
 +
 +<nowiki>In your browser's address field, type in www.yoursite.com/administration/siteinfo.php</nowiki>
 +
 +This page will display information about your server and the configuration of some settings made by your hosting company.The information we need is the Operating System and the microprocessor architecture. Don't worry - the page you're looking at makes getting this information very easy!
 +
 +The first row in the first table should display the information we need.
 +
 +{{http://www.68classifieds.com/manuals/mhtml/images/siteinfo.jpg}}
 +
 +
 +The two items highlighted here indicate our operating system and the microprocessor information. Your information may differ from the example.
 +
 +==== Step 3 ====
 +
 +Open a second browser window and visit http://www.ioncube.com/loaders.php
 +The page contains a list of run-time loaders which you can download. Look down the list and find the loader that is right for your system. Click on the accompanying Zip link. A new window should open asking if you want to open the file or save it to your computer. Save the file to a location you can remember. You can now close the second browser window.
 +
 +Once it has been saved, the file will need to be decompressed.
 +
 +==== Step 4 ====
 +
 +<nowiki>Once the file has been decompressed, revisit http://www.yoursite.com/install/index.php</nowiki>
 +
 +The warning ""The file /home/youraccount/public_html/install/index.php has been encoded with the ionCube PHP Encoder and requires the free ioncube_loader_something_here.so ionCube PHP Loader to be installed." should still be visible. Take note of the ioncube loader the page is saying is missing.
 +
 +==== Step 5 ====
 +
 +<nowiki>Next, connect to your server with your FTP program. Open the ioncube directory (/public_html/ioncube/) and upload the appropriate run-time loader file from the folder that you just decompressed. Once the file has been uploaded, revisit http://www.yoursite.com/install/index.php and refresh the page. The warning message should be gone and the first page of the installation should appear.</nowiki>
 +
 +If you continue to encounter problems after completing the steps in this section, please contact us so that we can help you get the problem resolved.
Line 21: Line 61:
Here is documentation from Ioncube's website: Here is documentation from Ioncube's website:
-> Encoder 6.5 needs Loader version 3.1 or greater as it has new security features that are not known about by the older Loaders. Loaders < 3.0 report newer files as corrupted, which isn't strictly correct but couldn't be avoided. Loader 3.0 would say that a newer Loader was required. +> Encoder 6.5 needs Loader version 3.1 or greater as it has new security features that are not known about by the older Loaders. Loaders < 3.0 report newer files as corrupted, which isn't strictly correct but couldn't be avoided. Loader 3.0 would say that a newer Loader was required.===== Level 2 Headline =====

Have more questions? Visit our community forums.