Extending XAMPP with PHP/Java Bridge

Page 1

Extending XAMPP with PHP/Java Bridge

writtenby PeterJ.Siegel January2006 http://www.peter-siegel.de This paper's intention XAMPP is a fine adjusted software solution based on Apache Web Server, MySQL, PHP and Perl. It has been developed by the ApacheFriends Project at http://www.apachefriends.org. The intention behind the great idea of creating XAMPP is a preconfigured package that is easy to handle and up-to-date. It guarantees a minimal waste of time during installation and configuration. The PHP/Java Bridge offers an elegant solution to connect PHP based applications to Java classes running in a virtual machine. It's an easy way to let PHP processes communicate with corresponding Java methods running in a thread within a JVM. For example, it is possible to integrate an Apache Lucene provided service into a web application with PHP powered interface. Additionally, PHP based web services can be connected to a J2EE based middleware. More information and downloadable packages are available on the project homepage http://php-java-bridge.sourceforge.net. This paper is designed as a short manual that shows how XAMPP could be extended easily by PHP/Java Bridge. It has been written during my private experimental experiences connecting PHP and Java. So all described steps have led to a smooth integration of PHP/Java Bridge into a running system based on XAMPP and the SuSE Linux distribution. This paper is dedicated to anybody who doesn't want to spend much time searching the web for hints and tips. However, this howto-manual doesn't raise a claim on completeness. No liability for any loss or damage will be assumed.

Extending XAMPP with PHP/Java Bridge

Page 2

pre-requisites
softwarecomponents
System XAMPP Linux,DistributionSuSE9.2Professional Version1.5.0 availableathttp://www.apachfriends.org Package: xampplinux1.5.0.tar.gz PHP/Java Bridge Version3.0.4 availableathttp://phpjavabridge.sourceforge.net/ Package: phpjavabridge3.0.41.FC4.i386.rpm(compiledrpmforFedoraCore4) Source: phpjavabridge_3.0.4tar.bz2

Installing XAMPP TheXAMPP1.5.0packagecontainsfollowingcomponents:

Apache2.0.55 MySQL5.0.15 PHP4.4.1 PHP5.0.5 Perl5.8.7 ProFTPD1.2.10 phpMyAdmin2.6.3pl3 OpenSSL0.9.8a GD2.0.1 Freetype22.1.7 libjpeg6b libpng1.2.7 gdbm1.8.0 zlib1.2.3 expat1.2 Sablotron1.0 libxml2.4.26 libxslt1.1.8 Ming0.2a

Webalizer2.01 pdfclass009e ncurses5.8 mod_perl2.0.1 FreeTDS0.63 gettext0.11.5 IMAPCClient2004e OpenLDAP(client)2.3.11 mhashlibrary0.8.18 mcryptlibrary2.5.7 cURL7.13.1 SQLite2.8.9(incaseofPHP5:2.8.14) phpSQLiteAdmin0.2 eAccelerator0.9.3 libapreq2.04dev FPDF1.5.3

Step 1: Install the XAMPP package Unpack the XAMPP package into directory '/opt'. An automatically created subdirectory '/opt/lampp' is filled with the package content. Apply the following console entry:
# tar xvfz xampp-linux-1.5.0.tar.gz -C '/opt'

Extending XAMPP with PHP/Java Bridge

Page 3

Note:Thebasedirectoryintheproceedingsofthisdocumentisdefinedas '/opt/lampp'. Step 2: Create a startup script for XAMPP The following startup script should be saved into directory '/etc/init.d'. At system startup, different services are going to be executed by start scripts. These scripts are originally located in directory '/etc/init.d' and they are registered by a soft link in at least one run level directory from 'rc0.d' to 'rc6.d'. All soft linked start scripts in one associated run level directory are called by the entry the run level master script '/etc/init.d/rc'. Startup script: /etc/init.d/lampp
#! /bin/sh # Written in 2005 by PJS # # Author: # Peter J. Siegel <peter@peter-siegel.de>, 2005 # # /etc/init.d/lampp # # Description: Start the XAMPP environment # ### END INIT INFO XAMPP_DIR=/opt/lampp case "$1" in start) echo "Starting LAMPP" $XAMPP_DIR/lampp start ;; stop) echo "Shutting down LAMPP" $XAMPP_DIR/lampp stop ;; restart) ## Stop the service and regardless of whether it was ## running or not, start it again. $0 stop $0 start ;; *) echo "Usage: $0 {start|stop|restart}" exit 1 ;; esac exit 0

Extending XAMPP with PHP/Java Bridge

Page 4

The start script can be executed automatically on system bootup. This can be set up with the runlevel editor in YaST:

Extending XAMPP with PHP/Java Bridge

Page 5

Step 3: Securing XAMPP Executefollowingcommandline:

# /opt/lampp/lampp start # /opt/lampp/lampp security

AninteractiveconfigurationofpasswordsforXAMPP,MySQLphpMyAdminand ProFTPdshouldbefulfilledwiththeselines:
XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: XAMPP: Quick security check... Your XAMPP pages are NOT secured by a password. Do you want to set a password? [yes] Password: Password (again): Password protection active. Please use 'lampp' as user name! MySQL is accessable via network. Normally that's not recommended. Do you want me to turn it off? [yes] Turned off. The MySQL/phpMyAdmin user pma has no password set!!! Do you want to set a password? [yes] Password: Password (again): Setting new MySQL pma password Setting phpMyAdmin's pma password to the new one. MySQL has no root password set!!! Do you want to set a password? [yes] Password: Password (again): Setting new MySQL root password. Change phpMyAdmin's authentication method. The FTP password is still set to 'lampp'. Do you want to change the password? [yes] Password: Password (again): Reload ProFTPD... Done.

LaunchingtheXAMPPpageinawebbrowserunderEchnaton'sIPaddresswillshow aloginwindowlikethis:

Extending XAMPP with PHP/Java Bridge

Page 6

LaunchingthephpMyAdminpageinawebbrowserundertheserveraddress "http://192.168.10.3/phpmyadmin"willshowaloginwindowlikethis:

Installing PHP/Java Bridge with a precompiled package Forconvenienceit'sabettersolutiontodownloadandinstallthecompiledpackage phpjavabridge3.0.41.FC4.i386.rpm.DespiteitismadefortheFedoraLinux distributionyoucanuseitforSuSELinux9.x,too. Step 1: Package Installation Performthepackageinstallationbyfollowingcommandline: # rpm -i php-java-bridge-3.0.4-1.FC4.i386.rpm --nodeps The'nodeps'optionshouldpreventanydependencymessagesthatmaybelongto missingPHPpackages.EveryneededPHPcomponentisjustinstalledwithXAMPP thatisunknownfortheRPMpackagemanager. Step 2: Directory Changes AfterpackageinstallationthefilesforPHP/JavaBridgeareinstalledintothese directories:
/etc/init.d/php-java-bridge /etc/php.d/java.ini /usr/lib/php/modules/JavaBridge.jar /usr/lib/php/modules/RunJavaBridge /usr/lib/php/modules/java.so /usr/lib/php/modules/libnatcJavaBridge.so /usr/sbin/php-java-bridge

Thedocumentationissavedinto/usr/share/doc/phpjavabridge3.0.4.

Extending XAMPP with PHP/Java Bridge

Page 7

However,XAMPPislocatedinanowndirectorytree/opt/lampp.ThePHP/Java BridgecanbeconnectedasanextensionforXAMPP,soallimportantfileslisted abovehavetobemovedintothereferringextensiondirectoryunder /opt/lampp/lib/php/extensions/nodebugnonzts20041030/.Thisisachievedby followingcommandlines:

# mv /usr/lib/php/modules/JavaBridge.jar /opt/lampp/lib/php/extensions/no-debug-non-zts-20041030/JavaBridge.jar # mv /usr/lib/php/modules/RunJavaBridge /opt/lampp/lib/php/extensions/no-debug-non-zts-20041030/RunJavaBridge # mv /usr/lib/php/modules/java.so /opt/lampp/lib/php/extensions/no-debug-non-zts-20041030/java.so # mv /usr/lib/php/modules/libnatcJavaBridge.so /opt/lampp/lib/php/extensions/no-debug-non-zts-20041030/libnatcJavaBridge.so # mv /usr/sbin/php-java-bridge /opt/lampp/bin/php-java-bridge # chmod 755 /opt/lampp/bin/php-java-bridge # mv /usr/share/doc/php-java-bridge-3.0.4 /opt/lampp/php-java-bridge-3.0.4

Step 3: New Configuration Entries In File php.ini ThePHP/JavaBridgeextensionanditsconfigurationneedtogetloadedbyPHPas partoftheXAMPPframework.Forthisreasonsomeadditionalentrieshavetobe made inthePHPconfigurationfile/opt/lampp/etc/php.ini,writtenattheendof sectionDynamicExtensions:
;;;;;;;;;;;;;;;;;;;;;;;;; ; php-java-bridge-3.0.4 ; ;;;;;;;;;;;;;;;;;;;;;;;;; extension = java.so [java] java.log_level="3" java.log_file="/opt/lampp/logs/php-java-bridge.log" java.java_home="/opt/lampp/java_home" java.java="/opt/lampp/java_home/bin/java" java.wrapper="/opt/lampp/lib/php/extensions/no-debug-non-zts-20041030/RunJavaBridge"

The directory /opt/lampp/java_home is a soft link that points to a directory containing the installed JRE. On most systems it is set in $JAVA_HOME. Followingcommandlinecreatesthissoftlink:
# ln -s $JAVA_HOME /opt/lampp/java_home

Extending XAMPP with PHP/Java Bridge

Page 8

Step 4: Modifications In The Backend Start Script TheRPMinstallationcreatesastartscriptforthePHP/JavaBridgebackend.Itis linkedautomaticallywithappropriaterunlevelstostartatsystembootup.Thestart scriptisnamed/etc/init.d/phpjavabridge.

Thestartscripthastobemodifiedtothechangeddirectories.Allchangesare highlighted.
#!/bin/bash # # php-java-bridge Startup script for the PHP/Java Bridge # # chkconfig: - 84 16 # description: The PHP/Java Bridge allows PHP scripts to access java based \ # applications running in a java application server # processname: php-java-bridge # pidfile: /var/run/php-java-bridge.pid # config: /etc/php.d/java.ini # Source function library. # . /etc/rc.d/init.d/functions prog=/opt/lampp/bin/php-java-bridge RETVAL=0 start() { echo -n $"Starting $prog: " exec $prog & RETVAL=$? echo [ $RETVAL = 0 ] && touch $prog return $RETVAL } stop() { echo -n $"Stopping $prog: " killproc $prog RETVAL=$? echo [ $RETVAL = 0 ] && rm -f $prog.pid } # See how we were called. case "$1" in start) start ;; stop) stop ;; status) status $prog RETVAL=$? ;; restart) stop start ;; *) echo $"Usage: $prog {start|stop|restart|status}" exit 1 esac exit $RETVAL

Extending XAMPP with PHP/Java Bridge

Page 9

Step 5: Result Check Selectthephpinfo()functiononthelocalXAMPP page.ScrolldowntotheJava section,thatshouldgiveinformationlikethis:

ExecutethepsAshellcommandthatshowsallrunningprocesses.Thethreads belongingtoXAMPPareextendedbyanadditionalJavathread:
11250 11260 11287 11290 11291 ? pts/3 pts/3 ? ? 00:00:00 00:00:00 00:00:00 00:00:00 00:00:00 proftpd mysqld_safe mysqld httpd java

Installing PHP/Java Bridge by source code compiling Precompiled packages for the PHP/Java Bridge are built against a certain PHP version.IftheJavasharedobject(java.so)dependsonaPHPversionthatdiffersfrom theinstalledone(e.g5.0vs.5.1.1)followingerrormightberisingup:
PHP warning: PHP startup: java.so: Cannot open shared object file no such file or directory in Unknown on line 0 PHP warning: PHP startup: (null): Unable to initialize module Module compiled with module API=20041030, debug=0, thread-safety=0 PHP compiled with module API=20050922, debug=0, thread-safety=0 These options need to match

Extending XAMPP with PHP/Java Bridge

Page 10

Liketheerrormessagesaysclearly:TheAPIversionsatcompiletimehavetobethe same.YoucanachievethisbycompilingthePHP/JavaBridgesourcecodeagainstthe installedPHPversion. Compile the PHP/Java Bridge source Assumingyouhaveextractedthesourcetreepackedinthetarfilewithfollowing commandline
# cat php-java-bridge_3.0.4.tar.bz2 | bunzip2 | tar xvf -

andchangetotheunpackedsourcedirectorywith
# cd php-java-bridge-3.0.4

Startthecompilationwith
# /opt/lampp/bin/phpize && ./configure --disable-servlet --with-java=/opt/lampp/java_home --with-php-config=/opt/lampp/bin/php-config

ThePHP/JavaBridgesourcedoesn'thaveaconfig.m4scriptthatisneededtocreate themakefilebyexecutingtheconfigurationscript./configure.Ifthemakefileis builtsuccessfully,startthecompilationandinstallationwiththecommandline

# make && make install

AllbuiltfilesthatbelongtothePHP/JavaBridgearesavedinsubdirectory modulesinthesourcedirectoryphp-java-bridge-3.0.4.Theyshould becopiedintotheXAMPPextensionsdirectory /opt/lampp/lib/php/extensions/no-debug-non-zts-20041030/. Finally,performstep3onpage7.