Installation Guide

Note: All the software installation and upgrades were successfully done in Red Hat Linux 9.0. Please read the installation guide in the IDE documentation to find out how to install PHP 5 beta 2 and necessary software on Red Hat Linux 9.0.

Contents

• 1. How to configure and install the PHPlus IDE (core)
• 1.1 Editing the configuration file for the IDE
• 1.2 Compiling the source
• 1.3 Setting the PHPLUS_HOME and starting the IDE
• 2. Installing PEAR libraries (optional) - required for several wizard supports
• 2.1 Installing PHP UNIT test package
• 2.2 Installing PHP Documentor package
• 2.3 Installing SOAP packages
• 3. Core Features

1. How to configure and install IDE core

Extract the source files (phplus_ide-1.2-src.tar.bz2) into a directory. (From here onwards $PHPLUS_HOME is used to indicate the path to the extracted phplus direcory)
For example if the archive is extracted into /usr/local/ then the $PHPLUS_HOME is /usr/local/phplus_ide

1.1 Editing the configuration file for the IDE

The configurations of the IDE are stored in $PHPLUS_HOME/main.cnf
To work with the IDE you need not to change most of the configurations. The configurations that you may need to be changed are list below.

phplus_lib_path
webbrowser_path
pathPhpEngine

Note : Refer to the well commented $PHPLUS_HOME/main.cnf configuration file

1.2 Compiling the source

Now change to the directory to which files are extracted and issue qmake and then make commands to compile the source

$ cd $PHPLUS_HOME
$ qmake
$ make

1.3 Setting PHPLUS_HOME environment variable and starting the IDE

Now set the PHPLUS_HOME enviroment variable to the directory in which the archive is extracted (i.e. $PHPLUS_HOME).

eg: If the archive is extracted into /usr/local
under bash shell you may set the environment variable as follows.
export PHPLUS_HOME=/usr/local/phplus_ide

To start the PHPlus IDE
Change to the installation directory (i.e. $PHPLUS_HOME) if you are not already inside it.
Then issue following commad:

$./phplus_ide &

2. PEAR PACKAGE INSTALLATION

Important:
If you have two versions of PHP in your machine. There will be two versions of pear command.Please make sure to use the pear command for PHP 5.

All these packages are optional for the IDE. But if you want to use the wizards you need to install them. For installation you need to download the latest stable versions of the pakages from the PEAR site.

All the packages are available under PHP License.(http://www.php.net/license/2_02.txt)
<http://pear.php.net>

YOU NEED TO EITHER DOWNLOAD THE LIBRARIES FROM THE PEAR SITE OR USE THE LIBRARIES (WE DOWNLOADED) FOR THE INSTALLATION PROCESS.

WARNING:
These packages do not work off-the-shelf with PHP 5 beta 2. You need to do some modification. Don't worry, we supply already modified libraries as well.

2.1 Installing PHP UNIT test package
Optional - install only if you want the Unit test facility from the IDE

/usr/local/bin/pear install PHPUnit-0.6.2.tgz

Note:
PHPUnit-0.6.2.tgz is the latest stable version of PHPUnit.
URL as at 4-12-2003: http://pear.php.net/package/PHPUnit

2.2 Installing PHP Documentor package

Optional - install only if you want the java-doc like documentation facility fromt the IDE

/usr/local/bin/pear install PhpDocumentor-1.2.3.tgz

Note:
PhpDocumentor-1.2.3.tgz is the latest stable version of PHPDocumentor.
URL as at 4-12-2003: http://pear.php.net/package/PHPDocumentor

2.3 Installing SOAP packages

Optional - install only if you want the facility of generating SOAP clients for any web service

You need to first install the dependent packages before install the SOAP package itself.

Installing the dependent packages (You may need to change the order of installation if the pear command suggests it)

/usr/local/bin/pear install HTTP_Request-1.1.1.tgz
/usr/local/bin/pear install Net_URL-1.0.10.tgz
/usr/local/bin/pear install Net_DIME-0.3.tgz
/usr/local/bin/pear install Mail_Mime-1.2.1.tgz

Now install SOAP package
/usr/local/bin/pear SOAP-0.8RC2.tgz

Note:
HTTP_Request-1.1.1.tgz
Net_URL-1.0.10.tgz
Net_DIME-0.3.tgz
Mail_Mime-1.2.1.tgz
SOAP-0.8RC2.tgz
URL as at 4-12-2003: http://pear.php.net/package/SOAP

*** This version of SOAP library does not directly work with PHP 5 beta 2. So, After you installed this library, go to the directory where all the pear libraries are placed. (usually /usr/local/lib/php/ in Red Hat Linux 9.0) and replace the SOAP folder with the SOAP edited (SOAP-0.8RC2-edited.tgz) library we provide.

3. Core features

• Multiple Document Interface
• General project management facilities
• PHP method discovery
• PHP, HTML syntax highlighting
• XMLCPlus Parser Wizard
• Deployer Wizard
• In built graphical CVS client

Additional features

• Documentor
• PHP UNIT Test skeleton generator
• SOAP client generator