PhpJavaBridge

Aus Goobi

Status dieses Artikels
Erstellt für Goobi Version:	1.5.1
Überprüft für Goobi Version:	1.5.1
Anmerkungen:	Dieses Dokumentation ist aktuell

Installation der Präsentationsschicht (php/Java bridge)

Vorraussetzungen

• Die Installation erfolgt hier Beispielhaft unter SUSE Linux Enterprise Server 10.
• Java 5 Runtime Environment (java-1_5_0-sun)

Installation der php/Java bridge

Es gibt verschiedene Möglichkeiten die php/Java bridge zu installieren und zu betreiben.

1. Als Anwendung innerhalb eines J2EE Containers (z.B. Tomcat, Geronimo,...).
2. Als standalone Service
3. Als PHP-Modul

Version 2 + 3 taugen eher für kleinere Installationen oder Entwicklungsumgebungen. Im folgenden wird eine Installation auf Basis von SUSE Enterprise Server 10 mit Java 1.5 und Tomcat5 beschrieben, verwendet wird die derzeit aktuellste Version der JavaBridge (5.3.3). Getestet und lauffähig sind auch Installationen mit Tomcat6 und Java 1.6 / 1.7 (getestet unter OpenSUSE 10.3 und 11).

• Eine lauffähige Java/Tomcat Umgebung wird vorausgesetzt.
• Herunterladen des J2EE Paketes - php-java-bridge_5.3.3_j2ee.zip (im Bereich downloads):

http://php-java-bridge.sourceforge.net/pjb/

• Entpacken von php-java-bridge_5.3.3_j2ee.zip

unzip php-java-bridge_5.3.3_j2ee.zip

• Verzeichnis erstellen

mkdir jBridge

• Entpacken von JavaBridge.war in das Verzeichnis jBridge

unzip JavaBridge.war -d jBridge

• In das Verzeichnis jBridge wechseln und Beispielskripte und veraltete Pakete entfernen

cd jBridge
rm *
rm -rf locale
rm WEB-INF/lib/documentBeanClient.jar
rm WEB-INF/lib/itext.jar
rm WEB-INF/lib/lucene.jar
rm WEB-INF/lib/numberGuess.jar
rm WEB-INF/lib/poi.jar

Man kann benötigte jar-Pakete auch durch aktuelle Versionen ersetzen (z.B. lucene-core-2.3.2.jar), flexibler ist es aber diese Pakete bei Bedarf mittels java_require() oder java_autoload() zu laden.

• Das bereinigte Verzeichnis als neue war-Anwendung packen.

jar cvf ../jBridge.war *

Die fertige Anwendung steht auch hier zum Download bereit: http://gdz.sub.uni-goettingen.de/uploads/media/jBridge.war

• Die Anwendung in den webapps-Ordner des Tomcat verschieben.

mv ../jBridge.war /srv/www/tomcat5/base/webapps/

• Den Tomcat neu starten.

/etc/init.d/tomcat5 restart

• php-Konfiguration anpassen

Im Verzeichnis /etc/php5/conf.d eine Datei java.ini mit folgendem Inhalt erstellen:

[java]
java.hosts     = 127.0.0.1:8080
java.servlet   = On

Weitere Konfigurationsmöglichkeiten findet man in der Dokumentation zur php/Java bridge.

In den php.ini Dateien (je nach Bedarf) /etc/php5/apache2/php.ini, /etc/php5/cli/php.ini und /etc/php5/fastcgi/php.ini folgende Zeile einfügen oder ändern:

allow_url_include = On

Alternativ kann man auch das Verzeichenis /srv/www/tomcat5/base/webapps/jBridge in das htdocs Verzeichnis des Apache kopieren und mit lokalen includes arbeiten. Mehr dazu findet man in der Dokumentation zur php/Java bridge.

• Apache Konfiguration neu laden

rcapache2 reload

Wenn bis hierher alles geklappt hat man eine lauffähige php/Java bridge.

Mit folgenden Anweisungen kann man z.B. die Funktionalitäten in eigene php-Scripte einbinden und zusätzliche Java-Pakete laden.

<?php
require_once('http://localhost:8080/jBridge/java/Java.inc');
java_require('lucene.jar');
...
?>