Getting Started

Preparation:

Before you continue, make sure you have:

A text editor to make changes to the "config.php" file.

A web server or hosted account with PHP and MySQL support.

An FTP program to upload the files and directories. (WSFTP or CuteFTP)

A web browser to run the installation.

Also make sure you know or have access to the following:

Your website FTP username and password.

Your MySQL hostname, username, password and database name.

Download:

Login to your Turnkey Web Tools account at http://www.turnkeywebtools.com/. Once logged in, select the format and version you would like to download. We always recommend that you download the latest version available.

Two formats are available for download, tar.gz (tar) and zip. If you are downloading to a Windows machine, select the zip format. After download you can either upload to your server or place locally if you are installing locally. Unix/Linux users should download the tar.gz format for extraction on the machine itself.

Choosing Your Version:

Because PHP Live Helper now uses encryption on a few key files you will also need to choose which version best suites your needs. You can choose between the following 3 versions "Zend", "NonZend" & "Ioncube".

Zend Version:
The zend version requires that your server have Zend Optimizer 2.1.0 or greater installed in order to run PHP Live Helper correctly. If you do not have it you can get it free at http:///www.zend.com/store/products/zend-optimizer.php
IMPORTANT: Make sure you upload the following files in binary mode: 'libsecure.php', 'upgrade.php', 'admin/libsecure.php', 'admin/install.php'

Non Zend (Source Guardian) / Ioncube:

The other two versions do not require any extra software be installed on your server but they can be a little more difficult to setup initially. Both of these versions offer both run-time loading or the option to alter your php.ini. If you do not have access to your php.ini then you will need to follow the directions for setting up run-time loading. Please note that NonZend only runs on Windows, Linux and FreeBSD systems. Ioncube will run on any system.

(Run-Time)
The run-time loading feature is the easiest way to run encoded files, and lets encoded files locate and install the correct Loader when needed.

For "Ioncube", For run-time loading to work, a directory called 'ioncube' containing the Loaders should be placed in or above the top directory of encoded files. For example, if you have encoded files in '/var/www/htdocs/phplivehelper', you might place the 'ioncube' directory   in '/var/www/htdocs'. The 'ioncube-rtl-tester.php' PHP script is provided to assist you with run-time install. Access the script from a web server or a PHP cli or cgi executable and it should tell you if run-time loading will work.

For "NonZend" a directory called 'ixed' containing the Loaders should be placed in or the root directory of domain. For example, if you have encoded files in '/var/www/htdocs/phplivehelper', you might place the 'ixed' directory in '/var/www/htdocs'. Note that for "NonZend", the 'ixed' directory must be placed in the root directory for the domain.

If you need a Loader that was not included with our package you can find the latest Loaders for "NonZend" at http://www.sourceguardian.com/ixeds/ and at http://www.ioncube.com/loaders/ for the "Ioncube" version.

(PHP.ini)
Installing in the php.ini file is also simple, and offers the best performance for encoded scripts. It is also required for systems that use safe mode, or if PHP has been built with thread support, e.g. on Windows.

For "Ioncube", the 'ioncube-install-assistant.php' PHP script is provided to assist with this. Access the script from a web server or a PHP cli or cgi executable and it should tell you which Loader to install, which file to edit and what you need to add (it's just a one line change).

For "NonZend", 'nonzend-howto-install.php' PHP script is provided to assist with this. Access the script from a web server or a PHP cli or cgi executable and it should tell you which Loader to install, which file to edit and what you need to add (it's just a one line change). You may need to move this file to the root directory of your domain in order for it to output the correct information on where files should be placed.

For more info on setting up 'Ioncube' please read the README file located in the 'ioncube' directory'.

Un-Packing:

After download you should unpack the software. If on Windows, you may use WinZip, WinRar or any other extraction software. If on a Unix/Linux based machine simply run the command "tar -zxvf phplivehelper_x_x.tar.gz".

File Preparation:

Before you upload the files you will need to make changes to the "config.php" file located in the "phplivehelper/admin/" directory. Your file should look something like the one located below:

<?PHP

// Hostname or ip of server

$servername="localhost";

// Username and password to log onto db server

$dbusername="root";

$dbpassword="";

// Name of database

$dbname="phplivehelper";

// Table prefixes. Do not change the value after the install has been finished!

//$dbprefix2="plh_"; // Uncomment this line if this is a new install.

Ignoring the lines that begin with "//" edit the variables within the config file to your correct settings. See below for a list of the variables and their functions.

$servername:	Usually you are fine leaving this at "localhost" but if the actually MySQL database is located on a different server you will need to change this to the proper hostname or IP address.
$dbusername:	Set this to the username you created or was assigned. If you set this up yourself through your hosting companies control panel, you will most likely have to add a prefix to this value.
$dbpassword:	Set this to your assigned or created password.
$dbname:	Set this to the name of the database you created or was assigned. This value may also need a prefix as the username above.
$dbprefix:	By default this is commented out and not used. You will note the "//" in front of this value. If you wish to use this, good if you house other information in the same database, uncomment this line by removing the "//" before the line.

File Upload:

Once the above procedures have been completed you will need to upload the files to your server. If you are installing locally, place the files into the proper directory. To upload simply select the whole unpacked directory and place it on your server. There is no need to do it file by file, and doing so may alter the paths and directory structures.

Installing:

   After your files have been uploaded, point your browser to your server where you
   uploaded the files. You will need to find the admin path and locate the install
   file. Example: http://www.yourserver.com/phplivehelper/admin/install.php

   Proceed to the Installation Steps